@finatic/client 0.9.3 → 0.9.5

package/dist/index.js

@@ -63,6 +63,13 @@ async function retryApiCall(fn, options = {}, config) {
         retryOnNetworkError: config?.retryOnNetworkError ?? options.retryOnNetworkError ?? true,
         onFailedAttempt: options.onFailedAttempt,
     };
+    const pRetryOptions = {
+        retries: opts.maxRetries,
+        minTimeout: opts.retryDelay,
+        maxTimeout: opts.retryMaxDelay,
+        factor: opts.retryMultiplier,
+        ...(opts.onFailedAttempt && { onFailedAttempt: opts.onFailedAttempt }),
+    };
     return await pRetry(async () => {
         try {
             return await fn();
@@ -81,13 +88,7 @@ async function retryApiCall(fn, options = {}, config) {
             // Re-throw to trigger retry
             throw error;
         }
-    }, {
-        retries: opts.maxRetries,
-        minTimeout: opts.retryDelay,
-        maxTimeout: opts.retryMaxDelay,
-        factor: opts.retryMultiplier,
-        onFailedAttempt: opts.onFailedAttempt,
-    });
+    }, pRetryOptions);
 }
 
 /**
@@ -637,7 +638,11 @@ function coerceEnumValue(input, EnumObj, enumName) {
         // Direct match by value (case-insensitive)
         const valueMatch = values.find(v => v.toLowerCase() === normalized.toLowerCase());
         if (valueMatch) {
-            return valueMatch;
+            // Find the enum key that has this value
+            const matchingKey = Object.keys(EnumObj).find(k => EnumObj[k] === valueMatch);
+            if (matchingKey) {
+                return EnumObj[matchingKey]; // Returns enum member (e.g., BrokerDataOrderStatusEnum.Filled)
+            }
         }
         // Match by key name (case-insensitive)
         const keyMatch = Object.keys(EnumObj).find(k => String(k).toLowerCase() === normalized.toLowerCase());
@@ -785,34 +790,6 @@ exports.BrokerDataOrderSideEnum = void 0;
     BrokerDataOrderSideEnum["Sell"] = "sell";
 })(exports.BrokerDataOrderSideEnum || (exports.BrokerDataOrderSideEnum = {}));
 
-/* tslint:disable */
-/* eslint-disable */
-/**
- * Finatic FastAPI Backend
- * FinaticAPI REST API
- *
- * The version of the OpenAPI document: 1.0.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-exports.BrokerDataOrderStatusEnum = void 0;
-(function (BrokerDataOrderStatusEnum) {
-    BrokerDataOrderStatusEnum["Submitted"] = "submitted";
-    BrokerDataOrderStatusEnum["New"] = "new";
-    BrokerDataOrderStatusEnum["PartiallyFilled"] = "partially_filled";
-    BrokerDataOrderStatusEnum["Filled"] = "filled";
-    BrokerDataOrderStatusEnum["PendingCancel"] = "pending_cancel";
-    BrokerDataOrderStatusEnum["Cancelled"] = "cancelled";
-    BrokerDataOrderStatusEnum["Rejected"] = "rejected";
-    BrokerDataOrderStatusEnum["Expired"] = "expired";
-    BrokerDataOrderStatusEnum["Created"] = "created";
-    BrokerDataOrderStatusEnum["Received"] = "received";
-    BrokerDataOrderStatusEnum["Queued"] = "queued";
-})(exports.BrokerDataOrderStatusEnum || (exports.BrokerDataOrderStatusEnum = {}));
-
 /* tslint:disable */
 /* eslint-disable */
 /**
@@ -1396,6 +1373,23 @@ class PaginatedData {
     toLocaleString() {
         return this.items.toLocaleString();
     }
+    /**
+     * Convert to JSON - returns just the items array for serialization.
+     * This allows clean serialization without exposing internal methods.
+     *
+     * @returns The items array
+     *
+     * @example
+     * ```typescript
+     * const orders = await sdk.getOrders();
+     * console.log(orders);  // Shows full PaginatedData with methods
+     * console.log(orders.toJSON());  // Shows just the items array
+     * JSON.stringify(orders);  // Automatically uses toJSON()
+     * ```
+     */
+    toJSON() {
+        return this.items;
+    }
     /**
      * Get the next page of data.
      * @returns Promise<PaginatedData<T>> - The next page (not wrapped in FinaticResponse)
@@ -1878,7 +1872,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.disconnectCompanyFromBrokerApiV1BrokersDisconnectCompanyConnectionIdDelete({ connectionId: resolvedParams.connectionId }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.disconnectCompanyFromBrokerApiV1BrokersDisconnectCompanyConnectionIdDelete({ connectionId: resolvedParams.connectionId ?? null }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -1982,9 +1976,9 @@ class BrokersWrapper {
      * Returns orders from connections the company has read access to.
      * @param params.brokerId {string} (optional) Filter by broker ID
      * @param params.connectionId {string} (optional) Filter by connection ID
-     * @param params.accountId {string} (optional) Filter by broker provided account ID
+     * @param params.accountId {string} (optional) Filter by broker provided account ID or internal account UUID
      * @param params.symbol {string} (optional) Filter by symbol
-     * @param params.orderStatus {BrokerDataOrderStatusEnum} (optional) Filter by order status (e.g., 'filled', 'pending_new', 'cancelled')
+     * @param params.orderStatus {string} (optional) Filter by order status (e.g., 'filled', 'pending_new', 'cancelled')
      * @param params.side {BrokerDataOrderSideEnum} (optional) Filter by order side (e.g., 'buy', 'sell')
      * @param params.assetType {BrokerDataAssetTypeEnum} (optional) Filter by asset type (e.g., 'stock', 'option', 'crypto', 'future')
      * @param params.limit {number} (optional) Maximum number of orders to return
@@ -2030,14 +2024,17 @@ class BrokersWrapper {
     async getOrders(params) {
         // Use params object (with default empty object)
         const resolvedParams = params || {};
-        if (params?.orderStatus !== undefined) {
-            params.orderStatus = coerceEnumValue(params.orderStatus, exports.BrokerDataOrderStatusEnum, 'orderStatus');
-        }
         if (params?.side !== undefined) {
-            params.side = coerceEnumValue(params.side, exports.BrokerDataOrderSideEnum, 'side');
+            const coerced = coerceEnumValue(params.side, exports.BrokerDataOrderSideEnum, 'side');
+            if (coerced !== undefined) {
+                params.side = coerced;
+            }
         }
         if (params?.assetType !== undefined) {
-            params.assetType = coerceEnumValue(params.assetType, exports.BrokerDataAssetTypeEnum, 'assetType');
+            const coerced = coerceEnumValue(params.assetType, exports.BrokerDataAssetTypeEnum, 'assetType');
+            if (coerced !== undefined) {
+                params.assetType = coerced;
+            }
         } // Authentication check
         if (!this.sessionId || !this.companyId) {
             throw new Error('Session not initialized. Call startSession() first.');
@@ -2067,7 +2064,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getOrdersApiV1BrokersDataOrdersGet({ brokerId: resolvedParams.brokerId, connectionId: resolvedParams.connectionId, accountId: resolvedParams.accountId, symbol: resolvedParams.symbol, orderStatus: resolvedParams.orderStatus, side: resolvedParams.side, assetType: resolvedParams.assetType, limit: resolvedParams.limit, offset: resolvedParams.offset, createdAfter: resolvedParams.createdAfter, createdBefore: resolvedParams.createdBefore, includeMetadata: resolvedParams.includeMetadata }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getOrdersApiV1BrokersDataOrdersGet({ ...(resolvedParams.brokerId !== undefined ? { brokerId: resolvedParams.brokerId } : {}), ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.accountId !== undefined ? { accountId: resolvedParams.accountId } : {}), ...(resolvedParams.symbol !== undefined ? { symbol: resolvedParams.symbol } : {}), ...(resolvedParams.orderStatus !== undefined ? { orderStatus: resolvedParams.orderStatus } : {}), ...(resolvedParams.side !== undefined ? { side: resolvedParams.side } : {}), ...(resolvedParams.assetType !== undefined ? { assetType: resolvedParams.assetType } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}), ...(resolvedParams.createdAfter !== undefined ? { createdAfter: resolvedParams.createdAfter } : {}), ...(resolvedParams.createdBefore !== undefined ? { createdBefore: resolvedParams.createdBefore } : {}), ...(resolvedParams.includeMetadata !== undefined ? { includeMetadata: resolvedParams.includeMetadata } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -2183,7 +2180,7 @@ class BrokersWrapper {
      * Returns positions from connections the company has read access to.
      * @param params.brokerId {string} (optional) Filter by broker ID
      * @param params.connectionId {string} (optional) Filter by connection ID
-     * @param params.accountId {string} (optional) Filter by broker provided account ID
+     * @param params.accountId {string} (optional) Filter by broker provided account ID or internal account UUID
      * @param params.symbol {string} (optional) Filter by symbol
      * @param params.side {BrokerDataOrderSideEnum} (optional) Filter by position side (e.g., 'long', 'short')
      * @param params.assetType {BrokerDataAssetTypeEnum} (optional) Filter by asset type (e.g., 'stock', 'option', 'crypto', 'future')
@@ -2232,13 +2229,22 @@ class BrokersWrapper {
         // Use params object (with default empty object)
         const resolvedParams = params || {};
         if (params?.side !== undefined) {
-            params.side = coerceEnumValue(params.side, exports.BrokerDataOrderSideEnum, 'side');
+            const coerced = coerceEnumValue(params.side, exports.BrokerDataOrderSideEnum, 'side');
+            if (coerced !== undefined) {
+                params.side = coerced;
+            }
         }
         if (params?.assetType !== undefined) {
-            params.assetType = coerceEnumValue(params.assetType, exports.BrokerDataAssetTypeEnum, 'assetType');
+            const coerced = coerceEnumValue(params.assetType, exports.BrokerDataAssetTypeEnum, 'assetType');
+            if (coerced !== undefined) {
+                params.assetType = coerced;
+            }
         }
         if (params?.positionStatus !== undefined) {
-            params.positionStatus = coerceEnumValue(params.positionStatus, exports.BrokerDataPositionStatusEnum, 'positionStatus');
+            const coerced = coerceEnumValue(params.positionStatus, exports.BrokerDataPositionStatusEnum, 'positionStatus');
+            if (coerced !== undefined) {
+                params.positionStatus = coerced;
+            }
         } // Authentication check
         if (!this.sessionId || !this.companyId) {
             throw new Error('Session not initialized. Call startSession() first.');
@@ -2268,7 +2274,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getPositionsApiV1BrokersDataPositionsGet({ brokerId: resolvedParams.brokerId, connectionId: resolvedParams.connectionId, accountId: resolvedParams.accountId, symbol: resolvedParams.symbol, side: resolvedParams.side, assetType: resolvedParams.assetType, positionStatus: resolvedParams.positionStatus, limit: resolvedParams.limit, offset: resolvedParams.offset, updatedAfter: resolvedParams.updatedAfter, updatedBefore: resolvedParams.updatedBefore, includeMetadata: resolvedParams.includeMetadata }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getPositionsApiV1BrokersDataPositionsGet({ ...(resolvedParams.brokerId !== undefined ? { brokerId: resolvedParams.brokerId } : {}), ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.accountId !== undefined ? { accountId: resolvedParams.accountId } : {}), ...(resolvedParams.symbol !== undefined ? { symbol: resolvedParams.symbol } : {}), ...(resolvedParams.side !== undefined ? { side: resolvedParams.side } : {}), ...(resolvedParams.assetType !== undefined ? { assetType: resolvedParams.assetType } : {}), ...(resolvedParams.positionStatus !== undefined ? { positionStatus: resolvedParams.positionStatus } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}), ...(resolvedParams.updatedAfter !== undefined ? { updatedAfter: resolvedParams.updatedAfter } : {}), ...(resolvedParams.updatedBefore !== undefined ? { updatedBefore: resolvedParams.updatedBefore } : {}), ...(resolvedParams.includeMetadata !== undefined ? { includeMetadata: resolvedParams.includeMetadata } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -2384,7 +2390,7 @@ class BrokersWrapper {
      * Returns balances from connections the company has read access to.
      * @param params.brokerId {string} (optional) Filter by broker ID
      * @param params.connectionId {string} (optional) Filter by connection ID
-     * @param params.accountId {string} (optional) Filter by broker provided account ID
+     * @param params.accountId {string} (optional) Filter by broker provided account ID or internal account UUID
      * @param params.isEndOfDaySnapshot {boolean} (optional) Filter by end-of-day snapshot status (true/false)
      * @param params.limit {number} (optional) Maximum number of balances to return
      * @param params.offset {number} (optional) Number of balances to skip for pagination
@@ -2457,7 +2463,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getBalancesApiV1BrokersDataBalancesGet({ brokerId: resolvedParams.brokerId, connectionId: resolvedParams.connectionId, accountId: resolvedParams.accountId, isEndOfDaySnapshot: resolvedParams.isEndOfDaySnapshot, limit: resolvedParams.limit, offset: resolvedParams.offset, balanceCreatedAfter: resolvedParams.balanceCreatedAfter, balanceCreatedBefore: resolvedParams.balanceCreatedBefore, includeMetadata: resolvedParams.includeMetadata }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getBalancesApiV1BrokersDataBalancesGet({ ...(resolvedParams.brokerId !== undefined ? { brokerId: resolvedParams.brokerId } : {}), ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.accountId !== undefined ? { accountId: resolvedParams.accountId } : {}), ...(resolvedParams.isEndOfDaySnapshot !== undefined ? { isEndOfDaySnapshot: resolvedParams.isEndOfDaySnapshot } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}), ...(resolvedParams.balanceCreatedAfter !== undefined ? { balanceCreatedAfter: resolvedParams.balanceCreatedAfter } : {}), ...(resolvedParams.balanceCreatedBefore !== undefined ? { balanceCreatedBefore: resolvedParams.balanceCreatedBefore } : {}), ...(resolvedParams.includeMetadata !== undefined ? { includeMetadata: resolvedParams.includeMetadata } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -2618,7 +2624,10 @@ class BrokersWrapper {
         // Use params object (with default empty object)
         const resolvedParams = params || {};
         if (params?.accountType !== undefined) {
-            params.accountType = coerceEnumValue(params.accountType, exports.BrokerDataAccountTypeEnum, 'accountType');
+            const coerced = coerceEnumValue(params.accountType, exports.BrokerDataAccountTypeEnum, 'accountType');
+            if (coerced !== undefined) {
+                params.accountType = coerced;
+            }
         } // Authentication check
         if (!this.sessionId || !this.companyId) {
             throw new Error('Session not initialized. Call startSession() first.');
@@ -2648,7 +2657,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getAccountsApiV1BrokersDataAccountsGet({ brokerId: resolvedParams.brokerId, connectionId: resolvedParams.connectionId, accountType: resolvedParams.accountType, status: resolvedParams.status, currency: resolvedParams.currency, limit: resolvedParams.limit, offset: resolvedParams.offset, includeMetadata: resolvedParams.includeMetadata }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getAccountsApiV1BrokersDataAccountsGet({ ...(resolvedParams.brokerId !== undefined ? { brokerId: resolvedParams.brokerId } : {}), ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.accountType !== undefined ? { accountType: resolvedParams.accountType } : {}), ...(resolvedParams.status !== undefined ? { status: resolvedParams.status } : {}), ...(resolvedParams.currency !== undefined ? { currency: resolvedParams.currency } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}), ...(resolvedParams.includeMetadata !== undefined ? { includeMetadata: resolvedParams.includeMetadata } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -2837,7 +2846,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getOrderFillsApiV1BrokersDataOrdersOrderIdFillsGet({ orderId: resolvedParams.orderId, connectionId: resolvedParams.connectionId, limit: resolvedParams.limit, offset: resolvedParams.offset, includeMetadata: resolvedParams.includeMetadata }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getOrderFillsApiV1BrokersDataOrdersOrderIdFillsGet({ orderId: resolvedParams.orderId ?? null, ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}), ...(resolvedParams.includeMetadata !== undefined ? { includeMetadata: resolvedParams.includeMetadata } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -3026,7 +3035,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getOrderEventsApiV1BrokersDataOrdersOrderIdEventsGet({ orderId: resolvedParams.orderId, connectionId: resolvedParams.connectionId, limit: resolvedParams.limit, offset: resolvedParams.offset, includeMetadata: resolvedParams.includeMetadata }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getOrderEventsApiV1BrokersDataOrdersOrderIdEventsGet({ orderId: resolvedParams.orderId ?? null, ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}), ...(resolvedParams.includeMetadata !== undefined ? { includeMetadata: resolvedParams.includeMetadata } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -3212,7 +3221,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getOrderGroupsApiV1BrokersDataOrdersGroupsGet({ brokerId: resolvedParams.brokerId, connectionId: resolvedParams.connectionId, limit: resolvedParams.limit, offset: resolvedParams.offset, createdAfter: resolvedParams.createdAfter, createdBefore: resolvedParams.createdBefore, includeMetadata: resolvedParams.includeMetadata }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getOrderGroupsApiV1BrokersDataOrdersGroupsGet({ ...(resolvedParams.brokerId !== undefined ? { brokerId: resolvedParams.brokerId } : {}), ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}), ...(resolvedParams.createdAfter !== undefined ? { createdAfter: resolvedParams.createdAfter } : {}), ...(resolvedParams.createdBefore !== undefined ? { createdBefore: resolvedParams.createdBefore } : {}), ...(resolvedParams.includeMetadata !== undefined ? { includeMetadata: resolvedParams.includeMetadata } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -3399,7 +3408,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getPositionLotsApiV1BrokersDataPositionsLotsGet({ brokerId: resolvedParams.brokerId, connectionId: resolvedParams.connectionId, accountId: resolvedParams.accountId, symbol: resolvedParams.symbol, positionId: resolvedParams.positionId, limit: resolvedParams.limit, offset: resolvedParams.offset }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getPositionLotsApiV1BrokersDataPositionsLotsGet({ ...(resolvedParams.brokerId !== undefined ? { brokerId: resolvedParams.brokerId } : {}), ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.accountId !== undefined ? { accountId: resolvedParams.accountId } : {}), ...(resolvedParams.symbol !== undefined ? { symbol: resolvedParams.symbol } : {}), ...(resolvedParams.positionId !== undefined ? { positionId: resolvedParams.positionId } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -3587,7 +3596,7 @@ class BrokersWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getPositionLotFillsApiV1BrokersDataPositionsLotsLotIdFillsGet({ lotId: resolvedParams.lotId, connectionId: resolvedParams.connectionId, limit: resolvedParams.limit, offset: resolvedParams.offset }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
+                const apiResponse = await this.api.getPositionLotFillsApiV1BrokersDataPositionsLotsLotIdFillsGet({ lotId: resolvedParams.lotId ?? null, ...(resolvedParams.connectionId !== undefined ? { connectionId: resolvedParams.connectionId } : {}), ...(resolvedParams.limit !== undefined ? { limit: resolvedParams.limit } : {}), ...(resolvedParams.offset !== undefined ? { offset: resolvedParams.offset } : {}) }, { headers: { 'x-request-id': requestId, ...(this.sessionId && this.companyId ? { 'x-session-id': this.sessionId, 'x-company-id': this.companyId, ...(this.csrfToken ? { 'x-csrf-token': this.csrfToken } : {}) } : {}) } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -3785,7 +3794,7 @@ class CompanyWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getCompanyApiV1CompanyCompanyIdGet({ companyId: resolvedParams.companyId }, { headers: { 'x-request-id': requestId } });
+                const apiResponse = await this.api.getCompanyApiV1CompanyCompanyIdGet({ companyId: resolvedParams.companyId ?? null }, { headers: { 'x-request-id': requestId } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -3967,7 +3976,7 @@ class SessionWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.initSessionApiV1SessionInitPost({ xApiKey: resolvedParams.xApiKey }, { headers: { 'x-request-id': requestId } });
+                const apiResponse = await this.api.initSessionApiV1SessionInitPost({ xApiKey: resolvedParams.xApiKey ?? null }, { headers: { 'x-request-id': requestId } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -4111,7 +4120,7 @@ class SessionWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.startSessionApiV1SessionStartPost({ oneTimeToken: resolvedParams.OneTimeToken, sessionStartRequest: resolvedParams.body }, { headers: { 'x-request-id': requestId } });
+                const apiResponse = await this.api.startSessionApiV1SessionStartPost({ oneTimeToken: resolvedParams.OneTimeToken ?? null, sessionStartRequest: resolvedParams.body ?? null }, { headers: { 'x-request-id': requestId } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -4423,7 +4432,7 @@ class SessionWrapper {
         });
         try {
             const response = await retryApiCall(async () => {
-                const apiResponse = await this.api.getSessionUserApiV1SessionSessionIdUserGet({ sessionId: resolvedParams.sessionId, xSessionId: resolvedParams.sessionId }, { headers: { 'x-request-id': requestId } });
+                const apiResponse = await this.api.getSessionUserApiV1SessionSessionIdUserGet({ sessionId: resolvedParams.sessionId ?? null, xSessionId: resolvedParams.sessionId ?? null }, { headers: { 'x-request-id': requestId } });
                 return await applyResponseInterceptors(apiResponse, this.sdkConfig);
             }, {}, this.sdkConfig);
             // Unwrap axios response immediately - get FinaticResponse object
@@ -4537,7 +4546,7 @@ function validateParams(schema, params, config) {
     }
     catch (error) {
         if (error instanceof z__namespace.ZodError) {
-            const message = `Validation failed: ${error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ')}`;
+            const message = `Validation failed: ${error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ')}`;
             if (config?.validationStrict) {
                 throw new ValidationError(message);
             }
@@ -5497,7 +5506,7 @@ const BrokersApiAxiosParamCreator = function (configuration) {
          * @summary Get Balances
          * @param {string | null} [brokerId] Filter by broker ID
          * @param {string | null} [connectionId] Filter by connection ID
-         * @param {string | null} [accountId] Filter by broker provided account ID
+         * @param {string | null} [accountId] Filter by broker provided account ID or internal account UUID
          * @param {boolean | null} [isEndOfDaySnapshot] Filter by end-of-day snapshot status (true/false)
          * @param {number} [limit] Maximum number of balances to return
          * @param {number} [offset] Number of balances to skip for pagination
@@ -5734,9 +5743,9 @@ const BrokersApiAxiosParamCreator = function (configuration) {
          * @summary Get Orders
          * @param {string | null} [brokerId] Filter by broker ID
          * @param {string | null} [connectionId] Filter by connection ID
-         * @param {string | null} [accountId] Filter by broker provided account ID
+         * @param {string | null} [accountId] Filter by broker provided account ID or internal account UUID
          * @param {string | null} [symbol] Filter by symbol
-         * @param {BrokerDataOrderStatusEnum | null} [orderStatus] Filter by order status (e.g., \&#39;filled\&#39;, \&#39;pending_new\&#39;, \&#39;cancelled\&#39;)
+         * @param {string | null} [orderStatus] Filter by order status (e.g., \&#39;filled\&#39;, \&#39;pending_new\&#39;, \&#39;cancelled\&#39;)
          * @param {BrokerDataOrderSideEnum | null} [side] Filter by order side (e.g., \&#39;buy\&#39;, \&#39;sell\&#39;)
          * @param {BrokerDataAssetTypeEnum | null} [assetType] Filter by asset type (e.g., \&#39;stock\&#39;, \&#39;option\&#39;, \&#39;crypto\&#39;, \&#39;future\&#39;)
          * @param {number} [limit] Maximum number of orders to return
@@ -5905,7 +5914,7 @@ const BrokersApiAxiosParamCreator = function (configuration) {
          * @summary Get Positions
          * @param {string | null} [brokerId] Filter by broker ID
          * @param {string | null} [connectionId] Filter by connection ID
-         * @param {string | null} [accountId] Filter by broker provided account ID
+         * @param {string | null} [accountId] Filter by broker provided account ID or internal account UUID
          * @param {string | null} [symbol] Filter by symbol
          * @param {BrokerDataOrderSideEnum | null} [side] Filter by position side (e.g., \&#39;long\&#39;, \&#39;short\&#39;)
          * @param {BrokerDataAssetTypeEnum | null} [assetType] Filter by asset type (e.g., \&#39;stock\&#39;, \&#39;option\&#39;, \&#39;crypto\&#39;, \&#39;future\&#39;)
@@ -6048,7 +6057,7 @@ const BrokersApiFp = function (configuration) {
          * @summary Get Balances
          * @param {string | null} [brokerId] Filter by broker ID
          * @param {string | null} [connectionId] Filter by connection ID
-         * @param {string | null} [accountId] Filter by broker provided account ID
+         * @param {string | null} [accountId] Filter by broker provided account ID or internal account UUID
          * @param {boolean | null} [isEndOfDaySnapshot] Filter by end-of-day snapshot status (true/false)
          * @param {number} [limit] Maximum number of balances to return
          * @param {number} [offset] Number of balances to skip for pagination
@@ -6134,9 +6143,9 @@ const BrokersApiFp = function (configuration) {
          * @summary Get Orders
          * @param {string | null} [brokerId] Filter by broker ID
          * @param {string | null} [connectionId] Filter by connection ID
-         * @param {string | null} [accountId] Filter by broker provided account ID
+         * @param {string | null} [accountId] Filter by broker provided account ID or internal account UUID
          * @param {string | null} [symbol] Filter by symbol
-         * @param {BrokerDataOrderStatusEnum | null} [orderStatus] Filter by order status (e.g., \&#39;filled\&#39;, \&#39;pending_new\&#39;, \&#39;cancelled\&#39;)
+         * @param {string | null} [orderStatus] Filter by order status (e.g., \&#39;filled\&#39;, \&#39;pending_new\&#39;, \&#39;cancelled\&#39;)
          * @param {BrokerDataOrderSideEnum | null} [side] Filter by order side (e.g., \&#39;buy\&#39;, \&#39;sell\&#39;)
          * @param {BrokerDataAssetTypeEnum | null} [assetType] Filter by asset type (e.g., \&#39;stock\&#39;, \&#39;option\&#39;, \&#39;crypto\&#39;, \&#39;future\&#39;)
          * @param {number} [limit] Maximum number of orders to return
@@ -6193,7 +6202,7 @@ const BrokersApiFp = function (configuration) {
          * @summary Get Positions
          * @param {string | null} [brokerId] Filter by broker ID
          * @param {string | null} [connectionId] Filter by connection ID
-         * @param {string | null} [accountId] Filter by broker provided account ID
+         * @param {string | null} [accountId] Filter by broker provided account ID or internal account UUID
          * @param {string | null} [symbol] Filter by symbol
          * @param {BrokerDataOrderSideEnum | null} [side] Filter by position side (e.g., \&#39;long\&#39;, \&#39;short\&#39;)
          * @param {BrokerDataAssetTypeEnum | null} [assetType] Filter by asset type (e.g., \&#39;stock\&#39;, \&#39;option\&#39;, \&#39;crypto\&#39;, \&#39;future\&#39;)
@@ -6713,7 +6722,7 @@ let FinaticConnect$1 = class FinaticConnect extends EventEmitter {
                 logger.debug?.('Creating new FinaticConnect instance');
                 const connectOptions = {
                     token,
-                    sdkConfig: sdkConfig,
+                    ...(sdkConfig !== undefined && { sdkConfig }),
                 };
                 instance = new FinaticConnect(connectOptions);
                 baseClass.instance = instance;