@coinbase-sample/prime-sdk-ts 0.6.3 → 0.7.0

package/dist/types/model/enums/XMControlStatus.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * This file is generated by Openapi Generator https://github.com/openapitools/openapi-generator
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ *  Do not edit the class manually.
+ */
+/**
+ * - TRADES_AND_WITHDRAWALS: Allowed to trade and withdraw. See XM Margin Methodology for full description of when trading and withdrawals are enabled or disabled.  - TRADES_ONLY: Allowed to trade but not withdraw. See XM Margin Methodology for full description of when trading and withdrawals are enabled or disabled.  - SESSION_LOCKED: Not allowed to trade or withdraw. See XM Margin Methodology for full description of when trading and withdrawals are enabled or disabled.
+ */
+export declare enum XMControlStatus {
+    XmControlStatusUnspecified = "XM_CONTROL_STATUS_UNSPECIFIED",
+    TradesAndWithdrawals = "TRADES_AND_WITHDRAWALS",
+    TradesOnly = "TRADES_ONLY",
+    SessionLocked = "SESSION_LOCKED"
+}

package/dist/types/model/enums/XMEntityCallStatus.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * This file is generated by Openapi Generator https://github.com/openapitools/openapi-generator
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ *  Do not edit the class manually.
+ */
+/**
+ * - ENTITY_NO_CALL: There are no margin calls  - ENTITY_OPEN_STANDARD_CALL: There is a standard margin call. There are no urgent margin calls, and no expired margin calls.  - ENTITY_OPEN_URGENT_CALL: There is an urgent margin call. It is possible that there could also be a standard margin call, but there are no expired margin calls.  - ENTITY_AGED_CALL: At least one open margin call is aged (standard or urgent). This may trigger the SESSION_LOCKED control status.
+ */
+export declare enum XMEntityCallStatus {
+    XmEntityCallStatusUnspecified = "XM_ENTITY_CALL_STATUS_UNSPECIFIED",
+    EntityNoCall = "ENTITY_NO_CALL",
+    EntityOpenStandardCall = "ENTITY_OPEN_STANDARD_CALL",
+    EntityOpenUrgentCall = "ENTITY_OPEN_URGENT_CALL",
+    EntityAgedCall = "ENTITY_AGED_CALL"
+}

package/dist/types/model/enums/XMMarginLevel.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * This file is generated by Openapi Generator https://github.com/openapitools/openapi-generator
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ *  Do not edit the class manually.
+ */
+/**
+ * - HEALTHY_THRESHOLD: Margin level is healthy  - DEFICIT_THRESHOLD: Margin level is breaching the deficit threshold (DT) which will result in the issuance of a Margin Call if this is still the case by the scheduled next Margin Call time (as defined in the margin methodology)  - WARNING_THRESHOLD: Margin level is breaching the warning threshold (WT) which will result in the issuance of a Margin Call if this is still the case by the scheduled next Margin Call (as defined in the margin methodology). WT is differentiated from DT in that it means margin health is approaching the UMCT  - URGENT_MARGIN_CALL_THRESHOLD: Margin level is breaching the UMCT and, as defined in the margin methodology, this will trigger an urgent margin call  - LIQUIDATION_THRESHOLD: Margin level is breaching the liquidation threshold (LT) and, as defined in the margin methodology, this will trigger the SESSION_LOCKED control status and liquidation may commence.
+ */
+export declare enum XMMarginLevel {
+    XmMarginLevelUnspecified = "XM_MARGIN_LEVEL_UNSPECIFIED",
+    HealthyThreshold = "HEALTHY_THRESHOLD",
+    DeficitThreshold = "DEFICIT_THRESHOLD",
+    WarningThreshold = "WARNING_THRESHOLD",
+    UrgentMarginCallThreshold = "URGENT_MARGIN_CALL_THRESHOLD",
+    LiquidationThreshold = "LIQUIDATION_THRESHOLD"
+}

package/dist/types/model/enums/XMParty.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * This file is generated by Openapi Generator https://github.com/openapitools/openapi-generator
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ *  Do not edit the class manually.
+ */
+/**
+ * - CBE: Coinbase Exchange, trading venue that can receive the XM loan  - FCM: Coinbase’s Futures Commission Merchant, trading venue that can receive the XM loan
+ */
+export declare enum XMParty {
+    XmPartyUnspecified = "XM_PARTY_UNSPECIFIED",
+    Cbe = "CBE",
+    Fcm = "FCM"
+}

package/dist/types/model/enums/index.d.ts

@@ -37,7 +37,14 @@ export { TransactionStatus } from './TransactionStatus';
 export { TransactionType } from './TransactionType';
 export { TransferLocationType } from './TransferLocationType';
 export { UserRole } from './UserRole';
+export { ValidatorStatus } from './ValidatorStatus';
 export { VisibilityStatus } from './VisibilityStatus';
 export { WalletDepositInstructionType } from './WalletDepositInstructionType';
 export { WalletType } from './WalletType';
 export { WalletVisibility } from './WalletVisibility';
+export { XMCallStatus } from './XMCallStatus';
+export { XMCallType } from './XMCallType';
+export { XMControlStatus } from './XMControlStatus';
+export { XMEntityCallStatus } from './XMEntityCallStatus';
+export { XMMarginLevel } from './XMMarginLevel';
+export { XMParty } from './XMParty';

package/dist/types/model/index.d.ts

@@ -27,7 +27,6 @@ export type { Conversion } from './Conversion';
 export type { ConversionDetail } from './ConversionDetail';
 export type { Counterparty } from './Counterparty';
 export type { CounterpartyDestination } from './CounterpartyDestination';
-export type { CreateAddressGroup } from './CreateAddressGroup';
 export type { CreateAllocationRequest } from './CreateAllocationRequest';
 export type { CreateAllocationResponse } from './CreateAllocationResponse';
 export type { CreateAllocationResponseBody } from './CreateAllocationResponseBody';
@@ -42,8 +41,10 @@ export type { CreatePortfolioAddressBookEntryResponse } from './CreatePortfolioA
 export type { CreateWalletResponse } from './CreateWalletResponse';
 export type { CreateWalletTransferResponse } from './CreateWalletTransferResponse';
 export type { CreateWalletWithdrawalResponse } from './CreateWalletWithdrawalResponse';
+export type { CrossMarginOverview } from './CrossMarginOverview';
 export type { DefiBalance } from './DefiBalance';
 export type { DestinationAlloc } from './DestinationAlloc';
+export type { EditOrderResponse } from './EditOrderResponse';
 export type { EntityBalance } from './EntityBalance';
 export type { EntityUser } from './EntityUser';
 export type { EstimatedNetworkFees } from './EstimatedNetworkFees';
@@ -57,6 +58,7 @@ export type { GetActivityResponse } from './GetActivityResponse';
 export type { GetAllocationResponse } from './GetAllocationResponse';
 export type { GetAllocationsByClientNettingIdResponse } from './GetAllocationsByClientNettingIdResponse';
 export type { GetBuyingPowerResponse } from './GetBuyingPowerResponse';
+export type { GetCrossMarginOverviewResponse } from './GetCrossMarginOverviewResponse';
 export type { GetEntityActivitiesResponse } from './GetEntityActivitiesResponse';
 export type { GetEntityAssetsResponse } from './GetEntityAssetsResponse';
 export type { GetEntityPaymentMethodDetailsResponse } from './GetEntityPaymentMethodDetailsResponse';
@@ -96,7 +98,6 @@ export type { GetPositionsResponse } from './GetPositionsResponse';
 export type { GetPostTradeCreditResponse } from './GetPostTradeCreditResponse';
 export type { GetTFTieredPricingFeesResponse } from './GetTFTieredPricingFeesResponse';
 export type { GetTransactionResponse } from './GetTransactionResponse';
-export type { GetWalletAddressesResponse } from './GetWalletAddressesResponse';
 export type { GetWalletBalanceResponse } from './GetWalletBalanceResponse';
 export type { GetWalletDepositInstructionsResponse } from './GetWalletDepositInstructionsResponse';
 export type { GetWalletResponse } from './GetWalletResponse';
@@ -109,6 +110,7 @@ export type { ListAggregateEntityPositionsResponse } from './ListAggregateEntity
 export type { ListEntityBalancesResponse } from './ListEntityBalancesResponse';
 export type { ListEntityPositionsResponse } from './ListEntityPositionsResponse';
 export type { ListOnchainAddressGroupsResponse } from './ListOnchainAddressGroupsResponse';
+export type { ListTransactionValidatorsResponse } from './ListTransactionValidatorsResponse';
 export type { ListWalletAddressesResponse } from './ListWalletAddressesResponse';
 export type { ListWeb3WalletBalancesResponse } from './ListWeb3WalletBalancesResponse';
 export type { LoanInfo } from './LoanInfo';
@@ -149,15 +151,17 @@ export type { RpcConfig } from './RpcConfig';
 export type { ScheduleFuturesSweepResponse } from './ScheduleFuturesSweepResponse';
 export type { SetAutoSweepResponse } from './SetAutoSweepResponse';
 export type { ShortCollateral } from './ShortCollateral';
+export type { StakingClaimRewardsResponse } from './StakingClaimRewardsResponse';
 export type { StakingInitiateResponse } from './StakingInitiateResponse';
-export type { StakingInputs } from './StakingInputs';
 export type { StakingUnstakeResponse } from './StakingUnstakeResponse';
 export type { TieredPricingFee } from './TieredPricingFee';
 export type { Transaction } from './Transaction';
 export type { TransactionMetadata } from './TransactionMetadata';
+export type { TransactionValidator } from './TransactionValidator';
 export type { TransferLocation } from './TransferLocation';
 export type { UserAction } from './UserAction';
 export type { Wallet } from './Wallet';
+export type { WalletClaimRewardsInputs } from './WalletClaimRewardsInputs';
 export type { WalletCryptoDepositInstructions } from './WalletCryptoDepositInstructions';
 export type { WalletFiatDepositInstructions } from './WalletFiatDepositInstructions';
 export type { WalletStakeInputs } from './WalletStakeInputs';
@@ -166,6 +170,11 @@ export type { Web3Asset } from './Web3Asset';
 export type { Web3Balance } from './Web3Balance';
 export type { Web3TransactionMetadata } from './Web3TransactionMetadata';
 export type { WithdrawalPower } from './WithdrawalPower';
+export type { XMLoan } from './XMLoan';
+export type { XMMarginCall } from './XMMarginCall';
+export type { XMPosition } from './XMPosition';
+export type { XMRiskNettingInfo } from './XMRiskNettingInfo';
+export type { XMSummary } from './XMSummary';
 export type { CreateATransferBetweenTwoWallets } from './createATransferBetweenTwoWallets';
 export type { AcceptQuoteRequest } from './AcceptQuoteRequest';
 export type { CreateConversionRequest } from './CreateConversionRequest';
@@ -176,11 +185,14 @@ export type { CreatePortfolioAddressBookEntryRequest } from './CreatePortfolioAd
 export type { CreateWalletDepositAddressRequest } from './CreateWalletDepositAddressRequest';
 export type { CreateWalletRequest } from './CreateWalletRequest';
 export type { CreateWalletWithdrawalRequest } from './CreateWalletWithdrawalRequest';
+export type { EditOrderRequest } from './EditOrderRequest';
+export type { ListTransactionValidatorsRequest } from './ListTransactionValidatorsRequest';
 export type { OrderPreviewRequest } from './OrderPreviewRequest';
 export type { PortfolioStakingInitiateRequest } from './PortfolioStakingInitiateRequest';
 export type { PortfolioStakingUnstakeRequest } from './PortfolioStakingUnstakeRequest';
 export type { ScheduleFuturesSweepRequest } from './ScheduleFuturesSweepRequest';
 export type { SetAutoSweepRequest } from './SetAutoSweepRequest';
+export type { StakingClaimRewardsRequest } from './StakingClaimRewardsRequest';
 export type { StakingInitiateRequest } from './StakingInitiateRequest';
 export type { StakingUnstakeRequest } from './StakingUnstakeRequest';
 export type { CreateNetAllocationRequest } from './CreateNetAllocationRequest';

package/dist/types/orders/index.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { CoinbaseCallOptions, IPrimeApiClient } from '../clients';
-import { ListOpenOrdersResponse, ListOpenOrdersRequest, ListOrderFillsRequest, ListOrderFillsResponse, ListPortfolioOrdersResponse, ListPortfolioOrdersRequest, GetOrderResponse, GetOrderRequest, GetOrderEditHistoryRequest, GetOrderEditHistoryResponse, ListPortfolioFillsRequest, ListPortfolioFillsResponse, CreateOrderPreviewRequest, CreateOrderPreviewResponse, CancelOrderRequest, CancelOrderResponse, CreateOrderRequest, CreateOrderResponse, CreateQuoteRequest, CreateQuoteResponse, AcceptQuoteRequest, AcceptQuoteResponse } from './types';
+import { ListOpenOrdersResponse, ListOpenOrdersRequest, ListOrderFillsRequest, ListOrderFillsResponse, ListPortfolioOrdersResponse, ListPortfolioOrdersRequest, GetOrderResponse, GetOrderRequest, GetOrderEditHistoryRequest, GetOrderEditHistoryResponse, ListPortfolioFillsRequest, ListPortfolioFillsResponse, CreateOrderPreviewRequest, CreateOrderPreviewResponse, CancelOrderRequest, CancelOrderResponse, CreateOrderRequest, CreateOrderResponse, CreateQuoteRequest, CreateQuoteResponse, AcceptQuoteRequest, AcceptQuoteResponse, EditOrderRequest, EditOrderResponse } from './types';
 export interface IOrdersService {
     getOrder(request: GetOrderRequest, options?: CoinbaseCallOptions): Promise<GetOrderResponse>;
     getOrderEditHistory(request: GetOrderEditHistoryRequest, options?: CoinbaseCallOptions): Promise<GetOrderEditHistoryResponse>;
@@ -27,6 +27,7 @@ export interface IOrdersService {
     createOrder(request: CreateOrderRequest, options?: CoinbaseCallOptions): Promise<CreateOrderResponse>;
     createQuote(request: CreateQuoteRequest, options?: CoinbaseCallOptions): Promise<CreateQuoteResponse>;
     acceptQuote(request: AcceptQuoteRequest, options?: CoinbaseCallOptions): Promise<AcceptQuoteResponse>;
+    editOrder(request: EditOrderRequest, options?: CoinbaseCallOptions): Promise<EditOrderResponse>;
 }
 export declare class OrdersService implements IOrdersService {
     private client;
@@ -42,4 +43,5 @@ export declare class OrdersService implements IOrdersService {
     createOrder(request: CreateOrderRequest, options?: CoinbaseCallOptions): Promise<CreateOrderResponse>;
     createQuote(request: CreateQuoteRequest, options?: CoinbaseCallOptions): Promise<CreateQuoteResponse>;
     acceptQuote(request: AcceptQuoteRequest, options?: CoinbaseCallOptions): Promise<AcceptQuoteResponse>;
+    editOrder(request: EditOrderRequest, options?: CoinbaseCallOptions): Promise<EditOrderResponse>;
 }

package/dist/types/orders/types.d.ts

@@ -15,7 +15,7 @@
  */
 import { Brand } from '../shared/brand';
 import { OrderSide, OrderStatus, OrderType } from '../model/enums/';
-import { GetOpenOrdersResponse, GetOrderFillsResponse, GetOrderResponse as internalGet, GetOrdersResponse, GetPortfolioFillsResponse, GetOrderEditHistoryResponse as internalEditHistory, OrderPreviewRequest, PostOrderPreviewResponse, CancelOrderResponse as internalCancel, CreateOrderResponse as internalCreateResp, CreateOrderRequest as internalCreate, QuoteResponse, AcceptQuoteRequest as internalAcceptQuoteReq, AcceptQuoteResponse as internalAcceptQuoteResp } from '../model/';
+import { GetOpenOrdersResponse, GetOrderFillsResponse, GetOrderResponse as internalGet, GetOrdersResponse, GetPortfolioFillsResponse, GetOrderEditHistoryResponse as internalEditHistory, OrderPreviewRequest, PostOrderPreviewResponse, CancelOrderResponse as internalCancel, CreateOrderResponse as internalCreateResp, CreateOrderRequest as internalCreate, QuoteResponse, AcceptQuoteRequest as internalAcceptQuoteReq, AcceptQuoteResponse as internalAcceptQuoteResp, EditOrderRequest as internalEditOrderRequest, EditOrderResponse as internalEditOrderResponse } from '../model/';
 import { Pagination } from '../shared/pagination';
 import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
 export type GetOrderRequest = {
@@ -83,3 +83,8 @@ export type GetOrderEditHistoryRequest = {
     orderId: string;
 };
 export type GetOrderEditHistoryResponse = Brand<Omit<internalEditHistory, 'orderEditHistory'>, 'GetOrderEditHistoryResponse'>;
+export type EditOrderRequest = internalEditOrderRequest & {
+    portfolioId: string;
+    orderId: string;
+};
+export type EditOrderResponse = Brand<internalEditOrderResponse, 'EditOrderResponse'>;

package/dist/types/paymentMethods/types.d.ts

@@ -21,5 +21,6 @@ export type ListEntityPaymentMethodsRequest = {
 export type ListEntityPaymentMethodsResponse = Brand<GetEntityPaymentMethodsResponse, 'ListEntityPaymentMethodsResponse'>;
 export type GetPaymentMethodRequest = {
     entityId: string;
+    paymentMethodId: string;
 };
 export type GetPaymentMethodResponse = Brand<GetEntityPaymentMethodDetailsResponse, 'GetPaymentMethodResponse'>;

package/dist/types/shared/dynamicEnumValidation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Dynamic enum validation system that automatically discovers and validates
+ * enum fields in request objects without manual service-specific configuration.
+ *
+ * This approach is more scalable and maintainable than manual validation rules.
+ */
+import { enumRegistry } from './enumRegistry';
+import { DynamicEnumValidationError, DynamicValidationConfig, FieldTypeInfo } from './enumValidationCore';
+/**
+ * Set global configuration for dynamic enum validation
+ */
+export declare function setDynamicValidationConfig(config: Partial<DynamicValidationConfig>): void;
+/**
+ * Get current dynamic validation configuration
+ */
+export declare function getDynamicValidationConfig(): DynamicValidationConfig;
+/**
+ * Main API: Validate and normalize request with type-safe generics
+ */
+export declare function dynamicValidateRequest<T>(request: T, config?: Partial<DynamicValidationConfig>): T;
+/**
+ * Get information about discovered enums
+ */
+export declare function getEnumInfo(): {
+    totalEnums: number;
+    enumNames: string[];
+    enumDetails: Record<string, {
+        values: string[];
+        keys: string[];
+    }>;
+};
+export { DynamicEnumValidationError, DynamicValidationConfig, FieldTypeInfo };
+export { enumRegistry };

package/dist/types/shared/dynamicEnumValidation.old.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Error thrown when a request contains invalid enum values
+ */
+export declare class DynamicEnumValidationError extends Error {
+    field: string;
+    value: string;
+    enumName: string;
+    validValues: string[];
+    validKeys?: string[] | undefined;
+    constructor(field: string, value: string, enumName: string, validValues: string[], validKeys?: string[] | undefined);
+}
+/**
+ * Registry of all available enums for dynamic lookup
+ */
+declare class EnumRegistry {
+    private enumMap;
+    private enumNameMap;
+    constructor();
+    /**
+     * Automatically register all enums from the model/enums directory
+     */
+    private registerAllEnums;
+    /**
+     * Check if an object is a valid enum
+     */
+    private isValidEnum;
+    /**
+     * Get enum by name
+     */
+    getEnum(enumName: string): Record<string, string> | undefined;
+    /**
+     * Get enum name for a given enum object
+     */
+    getEnumName(enumObject: Record<string, string>): string | undefined;
+    /**
+     * Find enum that contains a specific value
+     */
+    findEnumByValue(value: string): {
+        enum: Record<string, string>;
+        name: string;
+    } | undefined;
+    /**
+     * Find enum that contains a specific key
+     */
+    findEnumByKey(key: string): {
+        enum: Record<string, string>;
+        name: string;
+    } | undefined;
+    /**
+     * Get all registered enum names
+     */
+    getAllEnumNames(): string[];
+    /**
+     * Validate a value against a specific enum with prefix handling
+     */
+    validateEnumValue(enumName: string, value: string): {
+        valid: boolean;
+        normalizedValue?: string;
+        error?: string;
+    };
+}
+declare const enumRegistry: EnumRegistry;
+/**
+ * Validates and normalizes enum fields in a request object
+ */
+export declare function validateRequestEnums(request: any, options?: {
+    strict?: boolean;
+    autoNormalize?: boolean;
+}): {
+    validatedRequest: any;
+    errors: string[];
+};
+/**
+ * Simplified validation function that throws on first error
+ */
+export declare function validateAndNormalizeRequest(request: any): any;
+/**
+ * Configuration for dynamic validation
+ */
+export interface DynamicValidationConfig {
+    enabled?: boolean;
+    strict?: boolean;
+    autoNormalize?: boolean;
+    logWarnings?: boolean;
+}
+/**
+ * Set global dynamic validation configuration
+ */
+export declare function setDynamicValidationConfig(config: Partial<DynamicValidationConfig>): void;
+/**
+ * Get current dynamic validation configuration
+ */
+export declare function getDynamicValidationConfig(): DynamicValidationConfig;
+/**
+ * Type-safe dynamic enum validation function
+ *
+ * Automatically validates and normalizes enum values in request objects
+ * using the auto-generated prefix patterns from the OpenAPI specification.
+ *
+ * @param request - The request object to validate and normalize
+ * @param config - Optional validation configuration
+ * @returns The validated request with normalized enum values
+ *
+ * @example
+ * ```typescript
+ * const validated = dynamicValidateRequest<CreateOrderRequest>({
+ *   portfolioId: 'portfolio-123',
+ *   side: 'buy',      // → 'BUY'
+ *   type: 'market'    // → 'MARKET'
+ * });
+ * ```
+ */
+export declare function dynamicValidateRequest<T>(request: T, config?: Partial<DynamicValidationConfig>): T;
+/**
+ * Export the enum registry for advanced usage
+ */
+export { enumRegistry };
+/**
+ * Utility function to get information about available enums
+ */
+export declare function getEnumInfo(): {
+    enumNames: string[];
+    totalEnums: number;
+    enumDetails: Record<string, {
+        values: string[];
+        keys: string[];
+    }>;
+};

package/dist/types/shared/enumHelpers.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Copyright 2025-present Coinbase Global, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Enum transformation utilities for JavaScript developers.
+ * These helpers make it easier to work with enums by providing:
+ * - Case-insensitive enum lookups
+ * - CamelCase to SNAKE_CASE conversion
+ * - Enum validation with helpful error messages
+ * - Support for prefix-aware transformations
+ */
+/**
+ * Converts a string from various formats to the expected enum value format (SCREAMING_SNAKE_CASE)
+ *
+ * @param input - The input string in any case format
+ * @returns The normalized SCREAMING_SNAKE_CASE string
+ *
+ * @example
+ * normalizeEnumValue('buy') // 'BUY'
+ * normalizeEnumValue('marketOrder') // 'MARKET_ORDER'
+ * normalizeEnumValue('STOP_LIMIT') // 'STOP_LIMIT'
+ * normalizeEnumValue('Order_Type_Market') // 'ORDER_TYPE_MARKET'
+ */
+export declare function normalizeEnumValue(input: string): string;
+/**
+ * Safely gets an enum value by normalizing the input and checking if it exists
+ *
+ * @param enumObject - The enum object to search in
+ * @param input - The input value to normalize and find
+ * @param enumName - Optional enum name for better error messages
+ * @returns The matching enum value or undefined if not found
+ *
+ * @example
+ * import { OrderSide } from '../model/enums/OrderSide';
+ *
+ * getEnumValue(OrderSide, 'buy') // OrderSide.Buy
+ * getEnumValue(OrderSide, 'BUY') // OrderSide.Buy
+ * getEnumValue(OrderSide, 'invalid') // undefined
+ */
+export declare function getEnumValue<T extends Record<string, string>>(enumObject: T, input: string, enumName?: string): T[keyof T] | undefined;
+/**
+ * Gets an enum value with strict validation, throwing an error if not found
+ *
+ * @param enumObject - The enum object to search in
+ * @param input - The input value to normalize and find
+ * @param enumName - Optional enum name for better error messages
+ * @returns The matching enum value
+ * @throws Error if the enum value is not found
+ *
+ * @example
+ * import { OrderSide } from '../model/enums/OrderSide';
+ *
+ * requireEnumValue(OrderSide, 'buy') // OrderSide.Buy
+ * requireEnumValue(OrderSide, 'invalid') // throws Error
+ */
+export declare function requireEnumValue<T extends Record<string, string>>(enumObject: T, input: string, enumName?: string): T[keyof T];
+/**
+ * Checks if a string is a valid enum value (case-insensitive)
+ *
+ * @param enumObject - The enum object to check against
+ * @param input - The input value to validate
+ * @returns True if the input is a valid enum value
+ *
+ * @example
+ * import { OrderSide } from '../model/enums/OrderSide';
+ *
+ * isValidEnumValue(OrderSide, 'buy') // true
+ * isValidEnumValue(OrderSide, 'BUY') // true
+ * isValidEnumValue(OrderSide, 'invalid') // false
+ */
+export declare function isValidEnumValue<T extends Record<string, string>>(enumObject: T, input: string): boolean;
+/**
+ * Gets all possible enum values as an array
+ *
+ * @param enumObject - The enum object
+ * @returns Array of all enum values
+ *
+ * @example
+ * import { OrderSide } from '../model/enums/OrderSide';
+ *
+ * getEnumValues(OrderSide) // ['BUY', 'SELL']
+ */
+export declare function getEnumValues<T extends Record<string, string>>(enumObject: T): T[keyof T][];
+/**
+ * Gets all possible enum keys as an array
+ *
+ * @param enumObject - The enum object
+ * @returns Array of all enum keys
+ *
+ * @example
+ * import { OrderSide } from '../model/enums/OrderSide';
+ *
+ * getEnumKeys(OrderSide) // ['Buy', 'Sell']
+ */
+export declare function getEnumKeys<T extends Record<string, string>>(enumObject: T): (keyof T)[];
+/**
+ * Validates that a string has the correct prefix for enum values
+ * Useful for ensuring enum values follow expected patterns
+ *
+ * @param input - The enum value to check
+ * @param expectedPrefix - The expected prefix (e.g., 'ORDER_TYPE_', 'ACTIVITY_TYPE_')
+ * @param strict - If true, requires exact prefix match. If false, allows values without prefix
+ * @returns True if the prefix is correct
+ *
+ * @example
+ * validateEnumPrefix('ORDER_TYPE_MARKET', 'ORDER_TYPE_') // true
+ * validateEnumPrefix('MARKET', 'ORDER_TYPE_', false) // true (non-strict)
+ * validateEnumPrefix('MARKET', 'ORDER_TYPE_', true) // false (strict)
+ */
+export declare function validateEnumPrefix(input: string, expectedPrefix: string, strict?: boolean): boolean;
+/**
+ * Transforms enum input to the correct format, optionally adding a prefix
+ *
+ * @param input - The input string
+ * @param prefix - Optional prefix to add if not present
+ * @returns The transformed enum value
+ *
+ * @example
+ * transformEnumValue('market', 'ORDER_TYPE_') // 'ORDER_TYPE_MARKET'
+ * transformEnumValue('ORDER_TYPE_MARKET', 'ORDER_TYPE_') // 'ORDER_TYPE_MARKET'
+ * transformEnumValue('marketOrder') // 'MARKET_ORDER'
+ */
+export declare function transformEnumValue(input: string, prefix?: string): string;