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

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

@@ -0,0 +1,176 @@
+/**
+ * Represents a validation error for a specific parameter
+ */
+export interface ValidationError {
+    paramName: string;
+    message: string;
+    value?: any;
+}
+/**
+ * Validation result that accumulates errors with fluent/builder pattern support
+ */
+export declare class ValidationResult {
+    private errors;
+    /**
+     * Add a validation error
+     */
+    addError(paramName: string, message: string, value?: any): void;
+    /**
+     * Check if there are any validation errors
+     */
+    hasErrors(): boolean;
+    /**
+     * Get all validation errors
+     */
+    getErrors(): ValidationError[];
+    /**
+     * Validates that a required UUID parameter is present and valid.
+     * Returns this for method chaining.
+     *
+     * @example
+     * ```typescript
+     * validator
+     *   .validateRequiredUUID(request.portfolioId, 'portfolioId')
+     *   .validateRequiredUUID(request.orderId, 'orderId')
+     *   .check();
+     * ```
+     */
+    validateRequiredUUID(value: string | undefined | null, paramName: string): this;
+    /**
+     * Validates that an optional UUID parameter is valid if provided.
+     * Returns this for method chaining.
+     */
+    validateOptionalUUID(value: string | undefined | null, paramName: string): this;
+    /**
+     * Validates that a required string parameter is present and not empty.
+     * Returns this for method chaining.
+     */
+    validateRequiredString(value: string | undefined | null, paramName: string): this;
+    /**
+     * Validates that an optional string parameter is not empty if provided.
+     * Returns this for method chaining.
+     */
+    validateOptionalString(value: string | undefined | null, paramName: string): this;
+    /**
+     * Throw an exception if there are validation errors.
+     * Automatically detects the calling method name if no context is provided.
+     *
+     * @param contextMessage - Optional context message. If not provided, attempts to detect method name.
+     * @throws {CoinbasePrimeClientException} if there are validation errors
+     *
+     * @example
+     * ```typescript
+     * const validator = createValidator();
+     * validateRequiredUUID(validator, request.id, 'id');
+     * validator.throwIfInvalid(); // Automatically detects calling method
+     * ```
+     */
+    throwIfInvalid(contextMessage?: string): void;
+    /**
+     * Alias for throwIfInvalid() - more natural for fluent/builder pattern.
+     * Throw an exception if there are validation errors.
+     *
+     * @param contextMessage - Optional context message. If not provided, attempts to detect method name.
+     * @throws {CoinbasePrimeClientException} if there are validation errors
+     *
+     * @example
+     * ```typescript
+     * validator
+     *   .validateRequiredUUID(request.portfolioId, 'portfolioId')
+     *   .validateRequiredUUID(request.orderId, 'orderId')
+     *   .check(); // ✅ Fluent pattern
+     * ```
+     */
+    check(contextMessage?: string): void;
+    /**
+     * Attempts to extract the calling method name from the stack trace.
+     * This provides automatic context for validation errors.
+     * Falls back to 'Request validation failed' if method name cannot be determined.
+     */
+    private getCallerContext;
+}
+/**
+ * Validates that a string is a valid UUID v4 format
+ */
+export declare function isValidUUID(value: string): boolean;
+/**
+ * Validates that a required UUID parameter is present and valid
+ */
+export declare function validateRequiredUUID(validator: ValidationResult, value: string | undefined | null, paramName: string): void;
+/**
+ * Validates that an optional UUID parameter is valid if provided
+ */
+export declare function validateOptionalUUID(validator: ValidationResult, value: string | undefined | null, paramName: string): void;
+/**
+ * Validates that a required string parameter is present and not empty
+ */
+export declare function validateRequiredString(validator: ValidationResult, value: string | undefined | null, paramName: string): void;
+/**
+ * Validates that an optional string parameter is not empty if provided
+ */
+export declare function validateOptionalString(validator: ValidationResult, value: string | undefined | null, paramName: string): void;
+/**
+ * Convenience function to create a new ValidationResult
+ */
+export declare function createValidator(): ValidationResult;
+/**
+ * Creates a validator with property accessor support for automatic field name inference.
+ *
+ * @param source - The source object containing the fields to validate
+ *
+ * @example
+ * ```typescript
+ * validate(request)
+ *   .requiredUUID(r => r.portfolioId)
+ *   .requiredUUID(r => r.orderId)
+ *   .check();
+ * ```
+ */
+export declare function validate<T extends Record<string, any>>(source: T): PropertyValidator<T>;
+/**
+ * Validator with property accessor support for automatic field name inference.
+ * Uses Proxy to track property accesses and extract field names automatically.
+ */
+export declare class PropertyValidator<T extends Record<string, any>> {
+    private validator;
+    private source;
+    constructor(source: T);
+    /**
+     * Validates that a required UUID field is present and valid.
+     * Automatically extracts the field name from the property accessor.
+     *
+     * @example
+     * ```typescript
+     * validate(request)
+     *   .requiredUUID(r => r.portfolioId)
+     *   .check();
+     * ```
+     */
+    requiredUUID(accessor: (source: T) => string | undefined | null): this;
+    /**
+     * Validates that an optional UUID field is valid if provided.
+     */
+    optionalUUID(accessor: (source: T) => string | undefined | null): this;
+    /**
+     * Validates that a required string field is present and not empty.
+     */
+    requiredString(accessor: (source: T) => string | undefined | null): this;
+    /**
+     * Validates that an optional string field is not empty if provided.
+     */
+    optionalString(accessor: (source: T) => string | undefined | null): this;
+    /**
+     * Throws if there are validation errors.
+     * Automatically detects the calling method name.
+     */
+    check(contextMessage?: string): void;
+    /**
+     * Alias for check() for backward compatibility.
+     */
+    throwIfInvalid(contextMessage?: string): void;
+    /**
+     * Extracts the property name and value from a property accessor function.
+     * Uses a Proxy to track which property was accessed.
+     */
+    private extractProperty;
+}

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

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { IPrimeApiClient, CoinbaseCallOptions } from '../clients';
-import { CreateStakeRequest, CreateStakeResponse, CreateUnstakeRequest, CreateUnstakeResponse, CreatePortfolioStakeRequest, CreatePortfolioStakeResponse, CreatePortfolioUnstakeRequest, CreatePortfolioUnstakeResponse, QueryTransactionValidatorsRequest, QueryTransactionValidatorsResponse, ClaimRewardsRequest, ClaimRewardsResponse } from './types';
+import { CreateStakeRequest, CreateStakeResponse, CreateUnstakeRequest, CreateUnstakeResponse, CreatePortfolioStakeRequest, CreatePortfolioStakeResponse, CreatePortfolioUnstakeRequest, CreatePortfolioUnstakeResponse, QueryTransactionValidatorsRequest, QueryTransactionValidatorsResponse, ClaimRewardsRequest, ClaimRewardsResponse, PreviewUnstakeRequest, PreviewUnstakeResponse, GetUnstakingStatusRequest, GetUnstakingStatusResponse } from './types';
 export interface IStakingService {
     createStake(request: CreateStakeRequest, options?: CoinbaseCallOptions): Promise<CreateStakeResponse>;
     createUnstake(request: CreateUnstakeRequest, options?: CoinbaseCallOptions): Promise<CreateUnstakeResponse>;
@@ -22,6 +22,8 @@ export interface IStakingService {
     createPortfolioUnstake(request: CreatePortfolioUnstakeRequest, options?: CoinbaseCallOptions): Promise<CreatePortfolioUnstakeResponse>;
     queryTransactionValidators(request: QueryTransactionValidatorsRequest, options?: CoinbaseCallOptions): Promise<QueryTransactionValidatorsResponse>;
     claimRewards(request: ClaimRewardsRequest, options?: CoinbaseCallOptions): Promise<ClaimRewardsResponse>;
+    previewUnstake(request: PreviewUnstakeRequest, options?: CoinbaseCallOptions): Promise<PreviewUnstakeResponse>;
+    getUnstakingStatus(request: GetUnstakingStatusRequest, options?: CoinbaseCallOptions): Promise<GetUnstakingStatusResponse>;
 }
 export declare class StakingService implements IStakingService {
     private client;
@@ -32,4 +34,6 @@ export declare class StakingService implements IStakingService {
     createPortfolioUnstake(request: CreatePortfolioUnstakeRequest, options?: CoinbaseCallOptions): Promise<CreatePortfolioUnstakeResponse>;
     queryTransactionValidators(request: QueryTransactionValidatorsRequest, options?: CoinbaseCallOptions): Promise<QueryTransactionValidatorsResponse>;
     claimRewards(request: ClaimRewardsRequest, options?: CoinbaseCallOptions): Promise<ClaimRewardsResponse>;
+    previewUnstake(request: PreviewUnstakeRequest, options?: CoinbaseCallOptions): Promise<PreviewUnstakeResponse>;
+    getUnstakingStatus(request: GetUnstakingStatusRequest, options?: CoinbaseCallOptions): Promise<GetUnstakingStatusResponse>;
 }

package/dist/types/staking/types.d.ts

@@ -15,7 +15,7 @@
  */
 import { Brand } from '../shared/brand';
 import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
-import { StakingInitiateResponse, StakingInitiateRequest, StakingUnstakeResponse, PortfolioStakingInitiateRequest, PortfolioStakingInitiateResponse, PortfolioStakingUnstakeRequest, PortfolioStakingUnstakeResponse, ListTransactionValidatorsResponse as internalListTransactionValidatorsResponse, StakingClaimRewardsRequest as internalStakingClaimRewardsRequest, StakingClaimRewardsResponse as internalStakingClaimRewardsResponse } from 'src/model/';
+import { StakingInitiateResponse, StakingInitiateRequest, StakingUnstakeResponse, PortfolioStakingInitiateRequest, PortfolioStakingInitiateResponse, PortfolioStakingUnstakeRequest, PortfolioStakingUnstakeResponse, ListTransactionValidatorsResponse as internalListTransactionValidatorsResponse, StakingClaimRewardsRequest as internalStakingClaimRewardsRequest, StakingClaimRewardsResponse as internalStakingClaimRewardsResponse, PreviewUnstakeResponse as internalPreviewUnstakeResponse, GetUnstakingStatusResponse as internalGetUnstakingStatusResponse } from 'src/model/';
 export type CreateStakeRequest = StakingInitiateRequest & {
     portfolioId: string;
     walletId: string;
@@ -45,3 +45,14 @@ export type ClaimRewardsRequest = internalStakingClaimRewardsRequest & {
     walletId: string;
 };
 export type ClaimRewardsResponse = Brand<internalStakingClaimRewardsResponse, 'ClaimRewardsResponse'>;
+export type PreviewUnstakeRequest = {
+    portfolioId: string;
+    walletId: string;
+    amount: string;
+};
+export type PreviewUnstakeResponse = Brand<internalPreviewUnstakeResponse, 'PreviewUnstakeResponse'>;
+export type GetUnstakingStatusRequest = {
+    portfolioId: string;
+    walletId: string;
+};
+export type GetUnstakingStatusResponse = Brand<internalGetUnstakingStatusResponse, 'GetUnstakingStatusResponse'>;

package/dist/types/transactions/types.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { Brand } from '../shared/brand';
-import { TransactionType } from '../model/enums/';
+import { TransactionType, TravelRuleStatus } from '../model/enums/';
 import { GetPortfolioTransactionsResponse, GetWalletTransactionsResponse, GetTransactionResponse as internalGet, CreateConversionRequest as internalCreateConversion, CreateConversionResponse as internalCreateConversionResp, CreateATransferBetweenTwoWallets, CreateWalletWithdrawalRequest, CreateWalletWithdrawalResponse, CreateWalletTransferResponse, CreateOnchainTransactionRequest as internalCreate, CreateOnchainTransactionResponse as internalCreateResp } from '../model/';
 import { Pagination } from '../shared/pagination';
 import { PaginatedResponseMethods, BasePaginatedRequest } from '../shared/paginatedResponse';
@@ -24,6 +24,8 @@ export type ListPortfolioTransactionsRequest = Pagination & {
     types?: TransactionType[];
     startTime?: string;
     endTime?: string;
+    getNetworkUnifiedTransactions?: boolean;
+    travelRuleStatus?: TravelRuleStatus[];
 };
 type BaseListPortfolioTransactionsResponse = Brand<GetPortfolioTransactionsResponse, 'ListPortfolioTransactionsResponse'>;
 export type ListPortfolioTransactionsResponse = BaseListPortfolioTransactionsResponse & PaginatedResponseMethods<ListPortfolioTransactionsRequest & BasePaginatedRequest, BaseListPortfolioTransactionsResponse, any>;

package/dist/types/wallets/types.d.ts

@@ -22,6 +22,7 @@ export type ListWalletsRequest = Pagination & {
     portfolioId: string;
     type: WalletType;
     symbols?: string[];
+    getNetworkUnifiedWallets?: boolean;
 };
 export type BaseListWalletsResponse = Brand<GetWalletsResponse, 'ListWalletsResponse'>;
 export type ListWalletsResponse = BaseListWalletsResponse & PaginatedResponseMethods<ListWalletsRequest & BasePaginatedRequest, BaseListWalletsResponse, any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase-sample/prime-sdk-ts",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "main": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "exports": {
@@ -57,15 +57,15 @@
   "description": "",
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "@typescript-eslint/eslint-plugin": "^8.39.1",
-    "@typescript-eslint/parser": "^8.39.1",
-    "dotenv": "^17.2.1",
-    "eslint": "^9.33.0",
+    "@typescript-eslint/eslint-plugin": "^8.49.0",
+    "@typescript-eslint/parser": "^8.49.0",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
-    "js-yaml": "^4.1.0",
-    "prettier": "^3.6.2",
-    "typescript": "^5.9.2"
+    "js-yaml": "^4.1.1",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3"
   },
   "dependencies": {
     "@coinbase-sample/core-ts": "^0.2.1"