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

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

@@ -6,113 +6,10 @@ export interface ValidationError {
     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.
  *
@@ -132,7 +29,7 @@ export declare function validate<T extends Record<string, any>>(source: T): Prop
  * Uses Proxy to track property accesses and extract field names automatically.
  */
 export declare class PropertyValidator<T extends Record<string, any>> {
-    private validator;
+    private errors;
     private source;
     constructor(source: T);
     /**
@@ -159,15 +56,30 @@ export declare class PropertyValidator<T extends Record<string, any>> {
      * Validates that an optional string field is not empty if provided.
      */
     optionalString(accessor: (source: T) => string | undefined | null): this;
+    /**
+     * Validates that a required array field is present and not empty.
+     */
+    requiredArray(accessor: (source: T) => any[] | undefined | null): this;
+    /**
+     * Validates that a required boolean field is present.
+     */
+    requiredBoolean(accessor: (source: T) => boolean | 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.
+     * Add a validation error
      */
-    throwIfInvalid(contextMessage?: string): void;
+    addError(paramName: string, message: string, value?: any): void;
+    /**
+     * Check if there are any validation errors
+     */
+    hasErrors(): boolean;
+    /**
+     * Get all validation errors
+     */
+    getErrors(): ValidationError[];
     /**
      * Extracts the property name and value from a property accessor function.
      * Uses a Proxy to track which property was accessed.

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, PreviewUnstakeRequest, PreviewUnstakeResponse, GetUnstakingStatusRequest, GetUnstakingStatusResponse } from './types';
+import { CreateStakeRequest, CreateStakeResponse, CreateUnstakeRequest, CreateUnstakeResponse, CreatePortfolioStakeRequest, CreatePortfolioStakeResponse, CreatePortfolioUnstakeRequest, CreatePortfolioUnstakeResponse, QueryTransactionValidatorsRequest, QueryTransactionValidatorsResponse, ClaimRewardsRequest, ClaimRewardsResponse, PreviewUnstakeRequest, PreviewUnstakeResponse, GetUnstakingStatusRequest, GetUnstakingStatusResponse, GetStakingStatusRequest, GetStakingStatusResponse } from './types';
 export interface IStakingService {
     createStake(request: CreateStakeRequest, options?: CoinbaseCallOptions): Promise<CreateStakeResponse>;
     createUnstake(request: CreateUnstakeRequest, options?: CoinbaseCallOptions): Promise<CreateUnstakeResponse>;
@@ -24,6 +24,7 @@ export interface IStakingService {
     claimRewards(request: ClaimRewardsRequest, options?: CoinbaseCallOptions): Promise<ClaimRewardsResponse>;
     previewUnstake(request: PreviewUnstakeRequest, options?: CoinbaseCallOptions): Promise<PreviewUnstakeResponse>;
     getUnstakingStatus(request: GetUnstakingStatusRequest, options?: CoinbaseCallOptions): Promise<GetUnstakingStatusResponse>;
+    getStakingStatus(request: GetStakingStatusRequest, options?: CoinbaseCallOptions): Promise<GetStakingStatusResponse>;
 }
 export declare class StakingService implements IStakingService {
     private client;
@@ -36,4 +37,5 @@ export declare class StakingService implements IStakingService {
     claimRewards(request: ClaimRewardsRequest, options?: CoinbaseCallOptions): Promise<ClaimRewardsResponse>;
     previewUnstake(request: PreviewUnstakeRequest, options?: CoinbaseCallOptions): Promise<PreviewUnstakeResponse>;
     getUnstakingStatus(request: GetUnstakingStatusRequest, options?: CoinbaseCallOptions): Promise<GetUnstakingStatusResponse>;
+    getStakingStatus(request: GetStakingStatusRequest, options?: CoinbaseCallOptions): Promise<GetStakingStatusResponse>;
 }

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, PreviewUnstakeResponse as internalPreviewUnstakeResponse, GetUnstakingStatusResponse as internalGetUnstakingStatusResponse } 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, GetStakingStatusResponse as internalGetStakingStatusResponse } from 'src/model/';
 export type CreateStakeRequest = StakingInitiateRequest & {
     portfolioId: string;
     walletId: string;
@@ -56,3 +56,8 @@ export type GetUnstakingStatusRequest = {
     walletId: string;
 };
 export type GetUnstakingStatusResponse = Brand<internalGetUnstakingStatusResponse, 'GetUnstakingStatusResponse'>;
+export type GetStakingStatusRequest = {
+    portfolioId: string;
+    walletId: string;
+};
+export type GetStakingStatusResponse = Brand<internalGetStakingStatusResponse, 'GetStakingStatusResponse'>;

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

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { IPrimeApiClient, CoinbaseCallOptions } from '../clients';
-import { CreateConversionRequest, CreateConversionResponse, CreateOnchainTransactionRequest, CreateOnchainTransactionResponse, CreateTransferRequest, CreateTransferResponse, CreateWithdrawalRequest, CreateWithdrawalResponse, GetTransactionRequest, GetTransactionResponse, ListPortfolioTransactionsRequest, ListPortfolioTransactionsResponse, ListWalletTransactionsRequest, ListWalletTransactionsResponse } from './types';
+import { CreateConversionRequest, CreateConversionResponse, CreateOnchainTransactionRequest, CreateOnchainTransactionResponse, CreateTransferRequest, CreateTransferResponse, CreateWithdrawalRequest, CreateWithdrawalResponse, GetTransactionRequest, GetTransactionResponse, ListPortfolioTransactionsRequest, ListPortfolioTransactionsResponse, ListWalletTransactionsRequest, ListWalletTransactionsResponse, SubmitDepositTravelRuleRequest, SubmitDepositTravelRuleResponse } from './types';
 export interface ITransactionsService {
     getTransaction(request: GetTransactionRequest, options?: CoinbaseCallOptions): Promise<GetTransactionResponse>;
     listPortfolioTransactions(request: ListPortfolioTransactionsRequest, options?: CoinbaseCallOptions): Promise<ListPortfolioTransactionsResponse>;
@@ -23,6 +23,7 @@ export interface ITransactionsService {
     createTransfer(request: CreateTransferRequest, options?: CoinbaseCallOptions): Promise<CreateTransferResponse>;
     createWithdrawal(request: CreateWithdrawalRequest, options?: CoinbaseCallOptions): Promise<CreateWithdrawalResponse>;
     createOnchainTransaction(request: CreateOnchainTransactionRequest, options?: CoinbaseCallOptions): Promise<CreateOnchainTransactionResponse>;
+    submitDepositTravelRule(request: SubmitDepositTravelRuleRequest, options?: CoinbaseCallOptions): Promise<SubmitDepositTravelRuleResponse>;
 }
 export declare class TransactionsService implements ITransactionsService {
     private client;
@@ -34,4 +35,5 @@ export declare class TransactionsService implements ITransactionsService {
     createTransfer(request: CreateTransferRequest, options?: CoinbaseCallOptions): Promise<CreateTransferResponse>;
     createWithdrawal(request: CreateWithdrawalRequest, options?: CoinbaseCallOptions): Promise<CreateWithdrawalResponse>;
     createOnchainTransaction(request: CreateOnchainTransactionRequest, options?: CoinbaseCallOptions): Promise<CreateOnchainTransactionResponse>;
+    submitDepositTravelRule(request: SubmitDepositTravelRuleRequest, options?: CoinbaseCallOptions): Promise<SubmitDepositTravelRuleResponse>;
 }

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

@@ -15,7 +15,7 @@
  */
 import { Brand } from '../shared/brand';
 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 { GetPortfolioTransactionsResponse, GetWalletTransactionsResponse, GetTransactionResponse as internalGet, CreateConversionRequest as internalCreateConversion, CreateConversionResponse as internalCreateConversionResp, CreateATransferBetweenTwoWallets, CreateWalletWithdrawalRequest, CreateWalletWithdrawalResponse, CreateWalletTransferResponse, CreateOnchainTransactionRequest as internalCreate, CreateOnchainTransactionResponse as internalCreateResp, RequestToSubmitTravelRuleDataForAnExistingDepositTransaction, SubmitDepositTravelRuleDataResponse as internalSubmitTravelRuleResp } from '../model/';
 import { Pagination } from '../shared/pagination';
 import { PaginatedResponseMethods, BasePaginatedRequest } from '../shared/paginatedResponse';
 export type ListPortfolioTransactionsRequest = Pagination & {
@@ -63,4 +63,9 @@ export type CreateOnchainTransactionRequest = internalCreate & {
     walletId: string;
 };
 export type CreateOnchainTransactionResponse = Brand<internalCreateResp, 'CreateOnchainTransactionResponse'>;
+export type SubmitDepositTravelRuleRequest = RequestToSubmitTravelRuleDataForAnExistingDepositTransaction & {
+    portfolioId: string;
+    transactionId: string;
+};
+export type SubmitDepositTravelRuleResponse = Brand<internalSubmitTravelRuleResp, 'SubmitDepositTravelRuleResponse'>;
 export {};

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

@@ -20,7 +20,7 @@ import { Pagination } from '../shared/pagination';
 import { BasePaginatedRequest, PaginatedResponseMethods } from '../shared/paginatedResponse';
 export type ListWalletsRequest = Pagination & {
     portfolioId: string;
-    type: WalletType;
+    type?: WalletType;
     symbols?: string[];
     getNetworkUnifiedWallets?: boolean;
 };

package/dist/users/index.js

@@ -21,6 +21,7 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UsersService = void 0;
+const validation_1 = require("../shared/validation");
 const paginatedResponse_1 = require("../shared/paginatedResponse");
 class UsersService {
     constructor(client) {
@@ -28,6 +29,9 @@ class UsersService {
     }
     listUsers(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.entityId)
+                .check();
             const paginationParams = (0, paginatedResponse_1.getQueryParams)(this.client, request);
             const { limit, cursor, sortDirection, entityId } = request, queryParams = __rest(request, ["limit", "cursor", "sortDirection", "entityId"]);
             const finalQueryParams = Object.assign(Object.assign({}, paginationParams), queryParams);
@@ -43,6 +47,9 @@ class UsersService {
     }
     listPortfolioUsers(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.portfolioId)
+                .check();
             const paginationParams = (0, paginatedResponse_1.getQueryParams)(this.client, request);
             const { limit, cursor, sortDirection, portfolioId } = request, queryParams = __rest(request, ["limit", "cursor", "sortDirection", "portfolioId"]);
             const finalQueryParams = Object.assign(Object.assign({}, paginationParams), queryParams);

package/dist/wallets/index.js

@@ -37,6 +37,7 @@ exports.WalletsService = void 0;
  * limitations under the License.
  */
 const clients_1 = require("../clients");
+const validation_1 = require("../shared/validation");
 const paginatedResponse_1 = require("../shared/paginatedResponse");
 class WalletsService {
     constructor(client) {
@@ -44,6 +45,9 @@ class WalletsService {
     }
     listWallets(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.portfolioId)
+                .check();
             const paginationParams = (0, paginatedResponse_1.getQueryParams)(this.client, request);
             const { limit, cursor, portfolioId } = request, queryParams = __rest(request, ["limit", "cursor", "portfolioId"]);
             const finalQueryParams = Object.assign(Object.assign({}, paginationParams), queryParams);
@@ -60,6 +64,10 @@ class WalletsService {
     }
     getWallet(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.portfolioId)
+                .requiredUUID((r) => r.walletId)
+                .check();
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/wallets/${request.walletId}`,
                 callOptions: options,
@@ -69,6 +77,11 @@ class WalletsService {
     }
     getWalletDepositInstructions(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.portfolioId)
+                .requiredUUID((r) => r.walletId)
+                .requiredString((r) => r.depositType)
+                .check();
             let queryParams = {
                 depositType: request.depositType,
             };
@@ -88,6 +101,10 @@ class WalletsService {
     }
     listWalletAddresses(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.portfolioId)
+                .requiredUUID((r) => r.walletId)
+                .check();
             const paginationParams = (0, paginatedResponse_1.getQueryParams)(this.client, request);
             const { limit, cursor, portfolioId, walletId } = request, queryParams = __rest(request, ["limit", "cursor", "portfolioId", "walletId"]);
             const finalQueryParams = Object.assign(Object.assign({}, paginationParams), queryParams);
@@ -104,6 +121,11 @@ class WalletsService {
     }
     createWallet(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.portfolioId)
+                .requiredString((r) => r.name)
+                .requiredString((r) => r.symbol)
+                .check();
             const bodyParams = Object.assign(Object.assign({}, request), { portfolioId: undefined });
             const response = yield this.client.request({
                 url: `portfolios/${request.portfolioId}/wallets`,
@@ -116,6 +138,11 @@ class WalletsService {
     }
     createWalletDepositAddress(request, options) {
         return __awaiter(this, void 0, void 0, function* () {
+            (0, validation_1.validate)(request)
+                .requiredUUID((r) => r.portfolioId)
+                .requiredUUID((r) => r.walletId)
+                .requiredString((r) => r.networkId)
+                .check();
             const bodyParams = {
                 networkId: request.networkId,
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase-sample/prime-sdk-ts",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "main": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "exports": {
@@ -35,7 +35,9 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
     "build": "tsc",
     "lint": "eslint . --ext .js,.ts",
     "format": "prettier --write \"**/*.{js,ts,tsx,json,css,md}\"",
@@ -56,6 +58,7 @@
   "license": "ISC",
   "description": "",
   "devDependencies": {
+    "@types/jest": "^29.5.12",
     "@types/node": "^22.14.0",
     "@typescript-eslint/eslint-plugin": "^8.49.0",
     "@typescript-eslint/parser": "^8.49.0",
@@ -65,6 +68,7 @@
     "eslint-plugin-prettier": "^5.5.4",
     "js-yaml": "^4.1.1",
     "prettier": "^3.7.4",
+    "ts-jest": "^29.1.2",
     "typescript": "^5.9.3"
   },
   "dependencies": {