@finatic/client 0.9.3 → 0.9.5

package/dist/index.mjs

@@ -42,6 +42,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();
@@ -60,13 +67,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);
 }
 
 /**
@@ -616,7 +617,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());
@@ -764,34 +769,6 @@ var BrokerDataOrderSideEnum;
     BrokerDataOrderSideEnum["Sell"] = "sell";
 })(BrokerDataOrderSideEnum || (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.
- */
-var BrokerDataOrderStatusEnum;
-(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";
-})(BrokerDataOrderStatusEnum || (BrokerDataOrderStatusEnum = {}));
-
 /* tslint:disable */
 /* eslint-disable */
 /**
@@ -1375,6 +1352,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)
@@ -1857,7 +1851,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
@@ -1961,9 +1955,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
@@ -2009,14 +2003,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, BrokerDataOrderStatusEnum, 'orderStatus');
-        }
         if (params?.side !== undefined) {
-            params.side = coerceEnumValue(params.side, BrokerDataOrderSideEnum, 'side');
+            const coerced = coerceEnumValue(params.side, BrokerDataOrderSideEnum, 'side');
+            if (coerced !== undefined) {
+                params.side = coerced;
+            }
         }
         if (params?.assetType !== undefined) {
-            params.assetType = coerceEnumValue(params.assetType, BrokerDataAssetTypeEnum, 'assetType');
+            const coerced = coerceEnumValue(params.assetType, BrokerDataAssetTypeEnum, 'assetType');
+            if (coerced !== undefined) {
+                params.assetType = coerced;
+            }
         } // Authentication check
         if (!this.sessionId || !this.companyId) {
             throw new Error('Session not initialized. Call startSession() first.');
@@ -2046,7 +2043,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
@@ -2162,7 +2159,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')
@@ -2211,13 +2208,22 @@ class BrokersWrapper {
         // Use params object (with default empty object)
         const resolvedParams = params || {};
         if (params?.side !== undefined) {
-            params.side = coerceEnumValue(params.side, BrokerDataOrderSideEnum, 'side');
+            const coerced = coerceEnumValue(params.side, BrokerDataOrderSideEnum, 'side');
+            if (coerced !== undefined) {
+                params.side = coerced;
+            }
         }
         if (params?.assetType !== undefined) {
-            params.assetType = coerceEnumValue(params.assetType, BrokerDataAssetTypeEnum, 'assetType');
+            const coerced = coerceEnumValue(params.assetType, BrokerDataAssetTypeEnum, 'assetType');
+            if (coerced !== undefined) {
+                params.assetType = coerced;
+            }
         }
         if (params?.positionStatus !== undefined) {
-            params.positionStatus = coerceEnumValue(params.positionStatus, BrokerDataPositionStatusEnum, 'positionStatus');
+            const coerced = coerceEnumValue(params.positionStatus, BrokerDataPositionStatusEnum, 'positionStatus');
+            if (coerced !== undefined) {
+                params.positionStatus = coerced;
+            }
         } // Authentication check
         if (!this.sessionId || !this.companyId) {
             throw new Error('Session not initialized. Call startSession() first.');
@@ -2247,7 +2253,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
@@ -2363,7 +2369,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
@@ -2436,7 +2442,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
@@ -2597,7 +2603,10 @@ class BrokersWrapper {
         // Use params object (with default empty object)
         const resolvedParams = params || {};
         if (params?.accountType !== undefined) {
-            params.accountType = coerceEnumValue(params.accountType, BrokerDataAccountTypeEnum, 'accountType');
+            const coerced = coerceEnumValue(params.accountType, BrokerDataAccountTypeEnum, 'accountType');
+            if (coerced !== undefined) {
+                params.accountType = coerced;
+            }
         } // Authentication check
         if (!this.sessionId || !this.companyId) {
             throw new Error('Session not initialized. Call startSession() first.');
@@ -2627,7 +2636,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
@@ -2816,7 +2825,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
@@ -3005,7 +3014,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
@@ -3191,7 +3200,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
@@ -3378,7 +3387,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
@@ -3566,7 +3575,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
@@ -3764,7 +3773,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
@@ -3946,7 +3955,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
@@ -4090,7 +4099,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
@@ -4402,7 +4411,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
@@ -4516,7 +4525,7 @@ function validateParams(schema, params, config) {
     }
     catch (error) {
         if (error instanceof z.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);
             }
@@ -5476,7 +5485,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
@@ -5713,9 +5722,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
@@ -5884,7 +5893,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;)
@@ -6027,7 +6036,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
@@ -6113,9 +6122,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
@@ -6172,7 +6181,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;)
@@ -6692,7 +6701,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;
@@ -9074,5 +9083,5 @@ class FinaticConnect extends FinaticConnect$1 {
 // Marker to verify custom class is being used
 FinaticConnect.__CUSTOM_CLASS__ = true;
 
-export { AccountStatus, ApiError, BrokerDataAccountTypeEnum, BrokerDataAssetTypeEnum, BrokerDataOrderSideEnum, BrokerDataOrderStatusEnum, BrokerDataPositionStatusEnum, BrokersApi, BrokersApiAxiosParamCreator, BrokersApiFactory, BrokersApiFp, BrokersWrapper, CompanyApi, CompanyApiAxiosParamCreator, CompanyApiFactory, CompanyApiFp, CompanyWrapper, Configuration, EventEmitter, FDXAccountStatus, FDXAccountType, FDXAssetType, FDXBalanceType, FDXOrderClass, FDXOrderEventType, FDXOrderGroupType, FDXOrderSide, FDXOrderStatus, FDXOrderType, FDXPositionSide, FDXPositionStatus, FDXSecurityIdType, FDXTimeInForce, FinaticConnect, FinaticError, PaginatedData, SessionApi, SessionApiAxiosParamCreator, SessionApiFactory, SessionApiFp, SessionStatus, SessionWrapper, ValidationError, addErrorInterceptor, addRequestInterceptor, addResponseInterceptor, appendBrokerFilterToURL, appendThemeToURL, applyErrorInterceptors, applyRequestInterceptors, applyResponseInterceptors, coerceEnumValue, convertToPlainObject, defaultConfig, generateCacheKey, generateRequestId, getCache, getConfig, getLogger, handleError, numberSchema, retryApiCall, stringSchema, unwrapAxiosResponse, validateParams };
+export { AccountStatus, ApiError, BrokerDataAccountTypeEnum, BrokerDataAssetTypeEnum, BrokerDataOrderSideEnum, BrokerDataPositionStatusEnum, BrokersApi, BrokersApiAxiosParamCreator, BrokersApiFactory, BrokersApiFp, BrokersWrapper, CompanyApi, CompanyApiAxiosParamCreator, CompanyApiFactory, CompanyApiFp, CompanyWrapper, Configuration, EventEmitter, FDXAccountStatus, FDXAccountType, FDXAssetType, FDXBalanceType, FDXOrderClass, FDXOrderEventType, FDXOrderGroupType, FDXOrderSide, FDXOrderStatus, FDXOrderType, FDXPositionSide, FDXPositionStatus, FDXSecurityIdType, FDXTimeInForce, FinaticConnect, FinaticError, PaginatedData, SessionApi, SessionApiAxiosParamCreator, SessionApiFactory, SessionApiFp, SessionStatus, SessionWrapper, ValidationError, addErrorInterceptor, addRequestInterceptor, addResponseInterceptor, appendBrokerFilterToURL, appendThemeToURL, applyErrorInterceptors, applyRequestInterceptors, applyResponseInterceptors, coerceEnumValue, convertToPlainObject, defaultConfig, generateCacheKey, generateRequestId, getCache, getConfig, getLogger, handleError, numberSchema, retryApiCall, stringSchema, unwrapAxiosResponse, validateParams };
 //# sourceMappingURL=index.mjs.map