@bloque/sdk-accounts 0.0.25 → 0.0.27

package/dist/accounts-client.d.ts

@@ -3,7 +3,8 @@ import { BaseClient } from '@bloque/sdk-core';
 import { BancolombiaClient } from './bancolombia/bancolombia-client';
 import { CardClient } from './card/card-client';
 import { PolygonClient } from './polygon/polygon-client';
-import type { TransferParams, TransferResult } from './types';
+import type { ListAccountsParams, ListAccountsResult, TransferParams, TransferResult } from './types';
+import { UsClient } from './us/us-client';
 import { VirtualClient } from './virtual/virtual-client';
 /**
  * Accounts client for managing financial accounts and payment methods
@@ -19,8 +20,29 @@ export declare class AccountsClient extends BaseClient {
     readonly bancolombia: BancolombiaClient;
     readonly card: CardClient;
     readonly polygon: PolygonClient;
+    readonly us: UsClient;
     readonly virtual: VirtualClient;
     constructor(httpClient: HttpClient);
+    /**
+     * List accounts
+     *
+     * Retrieves a list of accounts, optionally filtered by holder URN.
+     *
+     * @param params - List parameters (optional)
+     * @returns Promise resolving to list of accounts
+     *
+     * @example
+     * ```typescript
+     * // List all accounts for the authenticated holder
+     * const result = await bloque.accounts.list();
+     *
+     * // List accounts for a specific holder
+     * const result = await bloque.accounts.list({
+     *   medium: 'card'
+     * });
+     * ```
+     */
+    list(params?: ListAccountsParams): Promise<ListAccountsResult>;
     /**
      * Transfer funds between accounts
      *
@@ -42,4 +64,9 @@ export declare class AccountsClient extends BaseClient {
      * ```
      */
     transfer(params: TransferParams): Promise<TransferResult>;
+    /**
+     * Maps API account response to SDK format
+     * @internal
+     */
+    private _mapAccountResponse;
 }

package/dist/bancolombia/bancolombia-client.d.ts

@@ -1,20 +1,57 @@
 import { BaseClient } from '@bloque/sdk-core';
-import type { BancolombiaAccount, CreateBancolombiaAccountParams, UpdateBancolombiaMetadataParams } from './types';
+import type { CreateAccountOptions } from '../types';
+import type { BancolombiaAccount, CreateBancolombiaAccountParams, ListBancolombiaAccountsParams, ListBancolombiaAccountsResult, UpdateBancolombiaMetadataParams } from './types';
 export declare class BancolombiaClient extends BaseClient {
+    /**
+     * List Bancolombia accounts
+     *
+     * Retrieves a list of Bancolombia accounts, optionally filtered by holder URN or specific account URN.
+     *
+     * @param params - List parameters (optional)
+     * @returns Promise resolving to list of Bancolombia accounts
+     *
+     * @example
+     * ```typescript
+     * // List all Bancolombia accounts for the authenticated holder
+     * const result = await bloque.accounts.bancolombia.list();
+     *
+     * // List Bancolombia accounts for a specific holder
+     * const result = await bloque.accounts.bancolombia.list({
+     *   holderUrn: 'did:bloque:bloque-root:nestor'
+     * });
+     *
+     * // Get a specific Bancolombia account
+     * const result = await bloque.accounts.bancolombia.list({
+     *   urn: 'did:bloque:account:bancolombia:abc-123'
+     * });
+     * ```
+     */
+    list(params?: ListBancolombiaAccountsParams): Promise<ListBancolombiaAccountsResult>;
     /**
      * Create a new Bancolombia account
      *
      * @param params - Bancolombia account creation parameters
+     * @param options - Creation options (optional)
      * @returns Promise resolving to the created Bancolombia account
      *
      * @example
      * ```typescript
+     * // Create without waiting
      * const account = await bloque.accounts.bancolombia.create({
      *   name: 'Main Account'
      * });
+     *
+     * // Create and wait for active status
+     * const account = await bloque.accounts.bancolombia.create({
+     *   name: 'Main Account'
+     * }, { waitLedger: true });
      * ```
      */
-    create(params?: CreateBancolombiaAccountParams): Promise<BancolombiaAccount>;
+    create(params?: CreateBancolombiaAccountParams, options?: CreateAccountOptions): Promise<BancolombiaAccount>;
+    /**
+     * Private method to poll account status until it becomes active
+     */
+    private _waitForActiveStatus;
     /**
      * Update Bancolombia account metadata
      *

package/dist/bancolombia/types.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Parameters for listing Bancolombia accounts
+ */
+export interface ListBancolombiaAccountsParams {
+    /**
+     * URN of the account holder (user or organization) to filter by
+     * @example "did:bloque:bloque-root:nestor"
+     */
+    holderUrn?: string;
+    /**
+     * URN of a specific Bancolombia account to retrieve
+     * @example "did:bloque:account:bancolombia:abc-123"
+     */
+    urn?: string;
+}
+/**
+ * Result of listing Bancolombia accounts
+ */
+export interface ListBancolombiaAccountsResult {
+    /** Array of Bancolombia accounts with balance information */
+    accounts: BancolombiaAccount[];
+}
 export interface CreateBancolombiaAccountParams {
     /**
      * URN of the account holder (user or organization)
@@ -81,4 +103,13 @@ export interface BancolombiaAccount {
      * Last update timestamp
      */
     updatedAt: string;
+    /**
+     * Token balances (optional, included in list responses and after creation)
+     */
+    balance?: Record<string, {
+        current: string;
+        pending: string;
+        in: string;
+        out: string;
+    }>;
 }

package/dist/card/card-client.d.ts

@@ -1,33 +1,58 @@
 import { BaseClient } from '@bloque/sdk-core';
 import type { TokenBalance } from '../internal/wire-types';
-import type { CardAccount, CardMovement, CreateCardParams, GetBalanceParams, ListCardParams, ListMovementsParams, UpdateCardMetadataParams } from './types';
+import type { CreateAccountOptions } from '../types';
+import type { CardAccount, CardMovement, CreateCardParams, GetBalanceParams, ListCardAccountsParams, ListCardAccountsResult, ListMovementsParams, UpdateCardMetadataParams } from './types';
 export declare class CardClient extends BaseClient {
     /**
      * Create a new card account
      *
      * @param params - Card creation parameters
+     * @param options - Creation options (optional)
      * @returns Promise resolving to the created card account
      *
      * @example
      * ```typescript
+     * // Create without waiting
      * const card = await bloque.accounts.card.create({
      *   name: 'My Card',
      * });
+     *
+     * // Create and wait for active status
+     * const card = await bloque.accounts.card.create({
+     *   name: 'My Card',
+     * }, { waitLedger: true });
      * ```
      */
-    create(params?: CreateCardParams): Promise<CardAccount>;
+    create(params?: CreateCardParams, options?: CreateAccountOptions): Promise<CardAccount>;
+    /**
+     * Private method to poll account status until it becomes active
+     */
+    private _waitForActiveStatus;
     /**
-     * List card accounts for a holder
+     * List card accounts
      *
-     * @param params - List parameters
-     * @returns Promise resolving to array of card accounts with balances
+     * Retrieves a list of card accounts, optionally filtered by holder URN or specific account URN.
+     *
+     * @param params - List parameters (optional)
+     * @returns Promise resolving to list of card accounts with balances
      *
      * @example
      * ```typescript
-     * const cards = await bloque.accounts.card.list();
+     * // List all card accounts for the authenticated holder
+     * const result = await bloque.accounts.card.list();
+     *
+     * // List card accounts for a specific holder
+     * const result = await bloque.accounts.card.list({
+     *   holderUrn: 'did:bloque:bloque-root:nestor'
+     * });
+     *
+     * // Get a specific card account
+     * const result = await bloque.accounts.card.list({
+     *   urn: 'did:bloque:account:card:usr-123:crd-456'
+     * });
      * ```
      */
-    list(params?: ListCardParams): Promise<CardAccount[]>;
+    list(params?: ListCardAccountsParams): Promise<ListCardAccountsResult>;
     /**
      * List card account movements/transactions
      *

package/dist/card/types.d.ts

@@ -1,12 +1,26 @@
 import type { CardType, TokenBalance, Transaction } from '../internal/wire-types';
 import type { SupportedAsset } from '../types';
-export interface ListCardParams {
+/**
+ * Parameters for listing card accounts
+ */
+export interface ListCardAccountsParams {
     /**
-     * URN of the account holder (user or organization)
-     *
-     * @example "did:bloque:user:123e4567"
+     * URN of the account holder (user or organization) to filter by
+     * @example "did:bloque:bloque-root:nestor"
      */
     holderUrn?: string;
+    /**
+     * URN of a specific card account to retrieve
+     * @example "did:bloque:account:card:usr-123:crd-456"
+     */
+    urn?: string;
+}
+/**
+ * Result of listing card accounts
+ */
+export interface ListCardAccountsResult {
+    /** Array of card accounts with balance information */
+    accounts: CardAccount[];
 }
 export interface ListMovementsParams {
     /**

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(t,e)=>{for(var a in e)__webpack_require__.o(e,a)&&!__webpack_require__.o(t,a)&&Object.defineProperty(t,a,{enumerable:!0,get:e[a]})},__webpack_require__.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e),__webpack_require__.r=t=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{CardClient:()=>CardClient,VirtualClient:()=>VirtualClient,PolygonClient:()=>PolygonClient,AccountsClient:()=>AccountsClient,BancolombiaClient:()=>BancolombiaClient});const sdk_core_namespaceObject=require("@bloque/sdk-core");class BancolombiaClient extends sdk_core_namespaceObject.BaseClient{async create(t={}){let e={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/bancolombia",body:e});return this._mapAccountResponse(a.result.account)}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,referenceCode:t.details.reference_code,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class CardClient extends sdk_core_namespaceObject.BaseClient{async create(t={}){let e={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{create:{card_type:"VIRTUAL"}},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/card",body:e});return this._mapAccountResponse(a.result.account)}async list(t){let e=new URLSearchParams({holder_urn:t?.holderUrn||this.httpClient.urn||"",medium:"card"});return(await this.httpClient.request({method:"GET",path:`/api/accounts?${e.toString()}`})).accounts.map(t=>({urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:t.balance}))}async movements(t){let e=new URLSearchParams,a=t.asset||"DUSD/6";if("DUSD/6"!==a&&"KSM/12"!==a)throw Error("Invalid asset type. Supported assets are USD and KSM.");e.set("asset",a),void 0!==t.limit&&e.set("limit",t.limit.toString()),t.before&&e.set("before",t.before),t.after&&e.set("after",t.after),t.reference&&e.set("reference",t.reference),t.direction&&e.set("direction",t.direction);let r=e.toString(),s=`/api/accounts/${t.urn}/movements${r?`?${r}`:""}`;return(await this.httpClient.request({method:"GET",path:s})).transactions}async balance(t){return(await this.httpClient.request({method:"GET",path:`/api/accounts/${t.urn}/balance`})).balance}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class PolygonClient extends sdk_core_namespaceObject.BaseClient{async create(t={}){let e={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",...t.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/polygon",body:e});return this._mapAccountResponse(a.result.account)}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,address:t.details.address,network:t.details.network,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class VirtualClient extends sdk_core_namespaceObject.BaseClient{async create(t){let e={first_name:t.firstName,last_name:t.lastName},a={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:e,metadata:{source:"sdk-typescript",...t.metadata}},r=await this.httpClient.request({method:"POST",path:"/api/mediums/virtual",body:a});return this._mapAccountResponse(r.result.account)}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,firstName:t.details.first_name,lastName:t.details.last_name,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class AccountsClient extends sdk_core_namespaceObject.BaseClient{bancolombia;card;polygon;virtual;constructor(t){super(t),this.bancolombia=new BancolombiaClient(this.httpClient),this.card=new CardClient(this.httpClient),this.polygon=new PolygonClient(this.httpClient),this.virtual=new VirtualClient(this.httpClient)}async transfer(t){let e=t.asset||"DUSD/6";if("DUSD/6"!==e&&"KSM/12"!==e)throw Error("Invalid asset type. Supported assets are USD and KSM.");let a={destination_account_urn:t.destinationUrn,amount:t.amount,asset:e,metadata:t.metadata},r=await this.httpClient.request({method:"POST",path:`/api/accounts/${t.sourceUrn}/transfer`,body:a});return{queueId:r.result.queue_id,status:r.result.status,message:r.result.message}}}for(var __rspack_i in exports.AccountsClient=__webpack_exports__.AccountsClient,exports.BancolombiaClient=__webpack_exports__.BancolombiaClient,exports.CardClient=__webpack_exports__.CardClient,exports.PolygonClient=__webpack_exports__.PolygonClient,exports.VirtualClient=__webpack_exports__.VirtualClient,__webpack_exports__)-1===["AccountsClient","BancolombiaClient","CardClient","PolygonClient","VirtualClient"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});
+"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(t,e)=>{for(var a in e)__webpack_require__.o(e,a)&&!__webpack_require__.o(t,a)&&Object.defineProperty(t,a,{enumerable:!0,get:e[a]})},__webpack_require__.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e),__webpack_require__.r=t=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{CardClient:()=>CardClient,VirtualClient:()=>VirtualClient,PolygonClient:()=>PolygonClient,AccountsClient:()=>AccountsClient,UsClient:()=>UsClient,BancolombiaClient:()=>BancolombiaClient});const sdk_core_namespaceObject=require("@bloque/sdk-core");class BancolombiaClient extends sdk_core_namespaceObject.BaseClient{async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","bancolombia"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({...this._mapAccountResponse(t),balance:t.balance}))}}async create(t={},e){let a={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},r=await this.httpClient.request({method:"POST",path:"/api/mediums/bancolombia",body:a}),n=this._mapAccountResponse(r.result.account);return e?.waitLedger?this._waitForActiveStatus(n.urn,e.timeout||6e4):n}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,referenceCode:t.details.reference_code,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:"balance"in t&&t.balance?t.balance:void 0}}}class CardClient extends sdk_core_namespaceObject.BaseClient{async create(t={},e){let a={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{create:{card_type:"VIRTUAL"}},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},r=await this.httpClient.request({method:"POST",path:"/api/mediums/card",body:a}),n=this._mapAccountResponse(r.result.account);return e?.waitLedger?this._waitForActiveStatus(n.urn,e.timeout||6e4):n}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","card"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:t.balance}))}}async movements(t){let e=new URLSearchParams,a=t.asset||"DUSD/6";if("DUSD/6"!==a&&"KSM/12"!==a)throw Error("Invalid asset type. Supported assets are USD and KSM.");e.set("asset",a),void 0!==t.limit&&e.set("limit",t.limit.toString()),t.before&&e.set("before",t.before),t.after&&e.set("after",t.after),t.reference&&e.set("reference",t.reference),t.direction&&e.set("direction",t.direction);let r=e.toString(),n=`/api/accounts/${t.urn}/movements${r?`?${r}`:""}`;return(await this.httpClient.request({method:"GET",path:n})).transactions}async balance(t){return(await this.httpClient.request({method:"GET",path:`/api/accounts/${t.urn}/balance`})).balance}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class PolygonClient extends sdk_core_namespaceObject.BaseClient{async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","polygon"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({...this._mapAccountResponse(t),balance:t.balance}))}}async create(t={},e){let a={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",...t.metadata}},r=await this.httpClient.request({method:"POST",path:"/api/mediums/polygon",body:a}),n=this._mapAccountResponse(r.result.account);return e?.waitLedger?this._waitForActiveStatus(n.urn,e.timeout||6e4):n}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,address:t.details.address,network:t.details.network,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:"balance"in t&&t.balance?t.balance:void 0}}}class UsClient extends sdk_core_namespaceObject.BaseClient{async getTosLink(t){let e=new URLSearchParams({redirect_uri:t.redirectUri});return{url:(await this.httpClient.request({method:"POST",path:`/api/mediums/us-account/tos-link?${e.toString()}`})).result.url}}async create(t,e){let a={street_line_1:t.address.streetLine1,street_line_2:t.address.streetLine2,city:t.address.city,state:t.address.state,postal_code:t.address.postalCode,country:t.address.country},r={type:t.type,first_name:t.firstName,middle_name:t.middleName,last_name:t.lastName,email:t.email,phone:t.phone,address:a,birth_date:t.birthDate,tax_identification_number:t.taxIdentificationNumber,gov_id_country:t.govIdCountry,gov_id_image_front:t.govIdImageFront,signed_agreement_id:t.signedAgreementId},n={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:r,metadata:{source:"sdk-typescript",...t.metadata}},s=await this.httpClient.request({method:"POST",path:"/api/mediums/us-account",body:n}),i=this._mapAccountResponse(s.result.account);return e?.waitLedger?this._waitForActiveStatus(i.urn,e.timeout||6e4):i}async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","us-account"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({urn:t.urn,id:t.id,type:t.details.type,firstName:t.details.first_name,middleName:t.details.middle_name,lastName:t.details.last_name,email:t.details.email,phone:t.details.phone,address:{streetLine1:t.details.address.street_line_1,streetLine2:t.details.address.street_line_2,city:t.details.address.city,state:t.details.address.state,postalCode:t.details.address.postal_code,country:t.details.address.country},birthDate:t.details.birth_date,accountNumber:t.details.account_number,routingNumber:t.details.routing_number,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:t.balance}))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,type:t.details.type,firstName:t.details.first_name,middleName:t.details.middle_name,lastName:t.details.last_name,email:t.details.email,phone:t.details.phone,address:{streetLine1:t.details.address.street_line_1,streetLine2:t.details.address.street_line_2,city:t.details.address.city,state:t.details.address.state,postalCode:t.details.address.postal_code,country:t.details.address.country},birthDate:t.details.birth_date,accountNumber:t.details.account_number,routingNumber:t.details.routing_number,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class VirtualClient extends sdk_core_namespaceObject.BaseClient{async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","virtual"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({...this._mapAccountResponse(t),balance:t.balance}))}}async create(t,e){let a={first_name:t.firstName,last_name:t.lastName},r={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:a,metadata:{source:"sdk-typescript",...t.metadata}},n=await this.httpClient.request({method:"POST",path:"/api/mediums/virtual",body:r}),s=this._mapAccountResponse(n.result.account);return e?.waitLedger?this._waitForActiveStatus(s.urn,e.timeout||6e4):s}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(console.log(r),!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,firstName:t.details.first_name,lastName:t.details.last_name,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:"balance"in t&&t.balance?t.balance:void 0}}}class AccountsClient extends sdk_core_namespaceObject.BaseClient{bancolombia;card;polygon;us;virtual;constructor(t){super(t),this.bancolombia=new BancolombiaClient(this.httpClient),this.card=new CardClient(this.httpClient),this.polygon=new PolygonClient(this.httpClient),this.us=new UsClient(this.httpClient),this.virtual=new VirtualClient(this.httpClient)}async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;e&&a.append("holder_urn",e);let r=a.toString(),n=r?`/api/accounts?${r}`:"/api/accounts";return{accounts:(await this.httpClient.request({method:"GET",path:n})).accounts.map(t=>this._mapAccountResponse(t))}}async transfer(t){let e=t.asset||"DUSD/6";if("DUSD/6"!==e&&"KSM/12"!==e)throw Error("Invalid asset type. Supported assets are USD and KSM.");let a={destination_account_urn:t.destinationUrn,amount:t.amount,asset:e,metadata:t.metadata},r=await this.httpClient.request({method:"POST",path:`/api/accounts/${t.sourceUrn}/transfer`,body:a});return{queueId:r.result.queue_id,status:r.result.status,message:r.result.message}}_mapAccountResponse(t){let e={};for(let[a,r]of Object.entries(t.balance))e[a]={current:r.current,pending:r.pending,in:r.in,out:r.out};return{id:t.id,urn:t.urn,medium:t.medium,details:t.details,ledgerId:t.ledger_account_id,status:t.status,ownerUrn:t.owner_urn,createdAt:t.created_at,updatedAt:t.updated_at,webhookUrl:t.webhook_url,metadata:t.metadata,balance:e}}}for(var __rspack_i in exports.AccountsClient=__webpack_exports__.AccountsClient,exports.BancolombiaClient=__webpack_exports__.BancolombiaClient,exports.CardClient=__webpack_exports__.CardClient,exports.PolygonClient=__webpack_exports__.PolygonClient,exports.UsClient=__webpack_exports__.UsClient,exports.VirtualClient=__webpack_exports__.VirtualClient,__webpack_exports__)-1===["AccountsClient","BancolombiaClient","CardClient","PolygonClient","UsClient","VirtualClient"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.d.ts

@@ -6,5 +6,7 @@ export * from './card/types';
 export * from './polygon/polygon-client';
 export * from './polygon/types';
 export * from './types';
+export * from './us/types';
+export * from './us/us-client';
 export * from './virtual/types';
 export * from './virtual/virtual-client';

package/dist/index.js

@@ -1 +1 @@
-import{BaseClient as t}from"@bloque/sdk-core";class e extends t{async create(t={}){let e={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/bancolombia",body:e});return this._mapAccountResponse(a.result.account)}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,referenceCode:t.details.reference_code,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class a extends t{async create(t={}){let e={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{create:{card_type:"VIRTUAL"}},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/card",body:e});return this._mapAccountResponse(a.result.account)}async list(t){let e=new URLSearchParams({holder_urn:t?.holderUrn||this.httpClient.urn||"",medium:"card"});return(await this.httpClient.request({method:"GET",path:`/api/accounts?${e.toString()}`})).accounts.map(t=>({urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:t.balance}))}async movements(t){let e=new URLSearchParams,a=t.asset||"DUSD/6";if("DUSD/6"!==a&&"KSM/12"!==a)throw Error("Invalid asset type. Supported assets are USD and KSM.");e.set("asset",a),void 0!==t.limit&&e.set("limit",t.limit.toString()),t.before&&e.set("before",t.before),t.after&&e.set("after",t.after),t.reference&&e.set("reference",t.reference),t.direction&&e.set("direction",t.direction);let s=e.toString(),r=`/api/accounts/${t.urn}/movements${s?`?${s}`:""}`;return(await this.httpClient.request({method:"GET",path:r})).transactions}async balance(t){return(await this.httpClient.request({method:"GET",path:`/api/accounts/${t.urn}/balance`})).balance}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class s extends t{async create(t={}){let e={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",...t.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/polygon",body:e});return this._mapAccountResponse(a.result.account)}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,address:t.details.address,network:t.details.network,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class r extends t{async create(t){let e={first_name:t.firstName,last_name:t.lastName},a={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:e,metadata:{source:"sdk-typescript",...t.metadata}},s=await this.httpClient.request({method:"POST",path:"/api/mediums/virtual",body:a});return this._mapAccountResponse(s.result.account)}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,firstName:t.details.first_name,lastName:t.details.last_name,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class n extends t{bancolombia;card;polygon;virtual;constructor(t){super(t),this.bancolombia=new e(this.httpClient),this.card=new a(this.httpClient),this.polygon=new s(this.httpClient),this.virtual=new r(this.httpClient)}async transfer(t){let e=t.asset||"DUSD/6";if("DUSD/6"!==e&&"KSM/12"!==e)throw Error("Invalid asset type. Supported assets are USD and KSM.");let a={destination_account_urn:t.destinationUrn,amount:t.amount,asset:e,metadata:t.metadata},s=await this.httpClient.request({method:"POST",path:`/api/accounts/${t.sourceUrn}/transfer`,body:a});return{queueId:s.result.queue_id,status:s.result.status,message:s.result.message}}}export{n as AccountsClient,e as BancolombiaClient,a as CardClient,s as PolygonClient,r as VirtualClient};
+import{BaseClient as t}from"@bloque/sdk-core";class e extends t{async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","bancolombia"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({...this._mapAccountResponse(t),balance:t.balance}))}}async create(t={},e){let a={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},r=await this.httpClient.request({method:"POST",path:"/api/mediums/bancolombia",body:a}),s=this._mapAccountResponse(r.result.account);return e?.waitLedger?this._waitForActiveStatus(s.urn,e.timeout||6e4):s}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,referenceCode:t.details.reference_code,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:"balance"in t&&t.balance?t.balance:void 0}}}class a extends t{async create(t={},e){let a={holder_urn:t?.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{create:{card_type:"VIRTUAL"}},metadata:{source:"sdk-typescript",name:t.name,...t.metadata}},r=await this.httpClient.request({method:"POST",path:"/api/mediums/card",body:a}),s=this._mapAccountResponse(r.result.account);return e?.waitLedger?this._waitForActiveStatus(s.urn,e.timeout||6e4):s}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","card"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:t.balance}))}}async movements(t){let e=new URLSearchParams,a=t.asset||"DUSD/6";if("DUSD/6"!==a&&"KSM/12"!==a)throw Error("Invalid asset type. Supported assets are USD and KSM.");e.set("asset",a),void 0!==t.limit&&e.set("limit",t.limit.toString()),t.before&&e.set("before",t.before),t.after&&e.set("after",t.after),t.reference&&e.set("reference",t.reference),t.direction&&e.set("direction",t.direction);let r=e.toString(),s=`/api/accounts/${t.urn}/movements${r?`?${r}`:""}`;return(await this.httpClient.request({method:"GET",path:s})).transactions}async balance(t){return(await this.httpClient.request({method:"GET",path:`/api/accounts/${t.urn}/balance`})).balance}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async updateName(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{metadata:{name:e}}});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,lastFour:t.details.card_last_four,productType:t.details.card_product_type,status:t.status,cardType:t.details.card_type,detailsUrl:t.details.card_url_details,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class r extends t{async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","polygon"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({...this._mapAccountResponse(t),balance:t.balance}))}}async create(t={},e){let a={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:{},metadata:{source:"sdk-typescript",...t.metadata}},r=await this.httpClient.request({method:"POST",path:"/api/mediums/polygon",body:a}),s=this._mapAccountResponse(r.result.account);return e?.waitLedger?this._waitForActiveStatus(s.urn,e.timeout||6e4):s}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,address:t.details.address,network:t.details.network,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:"balance"in t&&t.balance?t.balance:void 0}}}class s extends t{async getTosLink(t){let e=new URLSearchParams({redirect_uri:t.redirectUri});return{url:(await this.httpClient.request({method:"POST",path:`/api/mediums/us-account/tos-link?${e.toString()}`})).result.url}}async create(t,e){let a={street_line_1:t.address.streetLine1,street_line_2:t.address.streetLine2,city:t.address.city,state:t.address.state,postal_code:t.address.postalCode,country:t.address.country},r={type:t.type,first_name:t.firstName,middle_name:t.middleName,last_name:t.lastName,email:t.email,phone:t.phone,address:a,birth_date:t.birthDate,tax_identification_number:t.taxIdentificationNumber,gov_id_country:t.govIdCountry,gov_id_image_front:t.govIdImageFront,signed_agreement_id:t.signedAgreementId},s={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:r,metadata:{source:"sdk-typescript",...t.metadata}},n=await this.httpClient.request({method:"POST",path:"/api/mediums/us-account",body:s}),i=this._mapAccountResponse(n.result.account);return e?.waitLedger?this._waitForActiveStatus(i.urn,e.timeout||6e4):i}async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","us-account"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({urn:t.urn,id:t.id,type:t.details.type,firstName:t.details.first_name,middleName:t.details.middle_name,lastName:t.details.last_name,email:t.details.email,phone:t.details.phone,address:{streetLine1:t.details.address.street_line_1,streetLine2:t.details.address.street_line_2,city:t.details.address.city,state:t.details.address.state,postalCode:t.details.address.postal_code,country:t.details.address.country},birthDate:t.details.birth_date,accountNumber:t.details.account_number,routingNumber:t.details.routing_number,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:t.balance}))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,type:t.details.type,firstName:t.details.first_name,middleName:t.details.middle_name,lastName:t.details.last_name,email:t.details.email,phone:t.details.phone,address:{streetLine1:t.details.address.street_line_1,streetLine2:t.details.address.street_line_2,city:t.details.address.city,state:t.details.address.state,postalCode:t.details.address.postal_code,country:t.details.address.country},birthDate:t.details.birth_date,accountNumber:t.details.account_number,routingNumber:t.details.routing_number,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}}class n extends t{async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;a.append("medium","virtual"),e&&a.append("holder_urn",e),t?.urn&&a.append("urn",t.urn);let r=`/api/accounts?${a.toString()}`;return{accounts:(await this.httpClient.request({method:"GET",path:r})).accounts.map(t=>({...this._mapAccountResponse(t),balance:t.balance}))}}async create(t,e){let a={first_name:t.firstName,last_name:t.lastName},r={holder_urn:t.holderUrn||this.httpClient.urn||"",webhook_url:t.webhookUrl,ledger_account_id:t.ledgerId,input:a,metadata:{source:"sdk-typescript",...t.metadata}},s=await this.httpClient.request({method:"POST",path:"/api/mediums/virtual",body:r}),n=this._mapAccountResponse(s.result.account);return e?.waitLedger?this._waitForActiveStatus(n.urn,e.timeout||6e4):n}async _waitForActiveStatus(t,e){let a=Date.now();for(;;){if(Date.now()-a>e)throw Error(`Timeout waiting for account to become active. URN: ${t}`);let r=(await this.list({urn:t})).accounts[0];if(console.log(r),!r)throw Error(`Account not found. URN: ${t}`);if("active"===r.status)return r;if("creation_failed"===r.status)throw Error(`Account creation failed. URN: ${t}`);await new Promise(t=>setTimeout(t,2e3))}}async updateMetadata(t){let e={metadata:t.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t.urn}`,body:e});return this._mapAccountResponse(a.result.account)}async activate(t){return this._updateStatus(t,"active")}async freeze(t){return this._updateStatus(t,"frozen")}async disable(t){return this._updateStatus(t,"disabled")}async _updateStatus(t,e){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${t}`,body:{status:e}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(t){return{urn:t.urn,id:t.id,firstName:t.details.first_name,lastName:t.details.last_name,status:t.status,ownerUrn:t.owner_urn,ledgerId:t.ledger_account_id,webhookUrl:t.webhook_url,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at,balance:"balance"in t&&t.balance?t.balance:void 0}}}class i extends t{bancolombia;card;polygon;us;virtual;constructor(t){super(t),this.bancolombia=new e(this.httpClient),this.card=new a(this.httpClient),this.polygon=new r(this.httpClient),this.us=new s(this.httpClient),this.virtual=new n(this.httpClient)}async list(t){let e=t?.holderUrn||this.httpClient.urn,a=new URLSearchParams;e&&a.append("holder_urn",e);let r=a.toString(),s=r?`/api/accounts?${r}`:"/api/accounts";return{accounts:(await this.httpClient.request({method:"GET",path:s})).accounts.map(t=>this._mapAccountResponse(t))}}async transfer(t){let e=t.asset||"DUSD/6";if("DUSD/6"!==e&&"KSM/12"!==e)throw Error("Invalid asset type. Supported assets are USD and KSM.");let a={destination_account_urn:t.destinationUrn,amount:t.amount,asset:e,metadata:t.metadata},r=await this.httpClient.request({method:"POST",path:`/api/accounts/${t.sourceUrn}/transfer`,body:a});return{queueId:r.result.queue_id,status:r.result.status,message:r.result.message}}_mapAccountResponse(t){let e={};for(let[a,r]of Object.entries(t.balance))e[a]={current:r.current,pending:r.pending,in:r.in,out:r.out};return{id:t.id,urn:t.urn,medium:t.medium,details:t.details,ledgerId:t.ledger_account_id,status:t.status,ownerUrn:t.owner_urn,createdAt:t.created_at,updatedAt:t.updated_at,webhookUrl:t.webhook_url,metadata:t.metadata,balance:e}}}export{i as AccountsClient,e as BancolombiaClient,a as CardClient,r as PolygonClient,s as UsClient,n as VirtualClient};

package/dist/internal/wire-types.d.ts

@@ -16,7 +16,7 @@ export type AccountStatus = 'active' | 'disabled' | 'frozen' | 'deleted' | 'crea
 export interface Account<TDetails = unknown> {
     id: string;
     urn: string;
-    medium: 'bancolombia' | 'card' | 'virtual' | 'polygon';
+    medium: 'bancolombia' | 'card' | 'virtual' | 'us-account' | 'polygon';
     details: TDetails;
     ledger_account_id: string;
     status: AccountStatus;
@@ -120,6 +120,68 @@ export type PolygonDetails = {
     address: string;
     network: string;
 };
+/**
+ * @internal
+ * US account type
+ */
+export type UsAccountType = 'individual' | 'business';
+/**
+ * @internal
+ * US account address for creation
+ */
+export interface UsAccountAddress {
+    street_line_1: string;
+    street_line_2?: string;
+    city: string;
+    state: string;
+    postal_code: string;
+    country: string;
+}
+/**
+ * @internal
+ * US account input for creation
+ */
+export interface CreateUsAccountInput {
+    type: UsAccountType;
+    first_name: string;
+    middle_name?: string;
+    last_name: string;
+    email: string;
+    phone: string;
+    address: UsAccountAddress;
+    birth_date: string;
+    tax_identification_number: string;
+    gov_id_country: string;
+    gov_id_image_front: string;
+    signed_agreement_id: string;
+}
+/**
+ * @internal
+ * US account details from API
+ */
+export interface UsDetails {
+    id: string;
+    type: UsAccountType;
+    first_name: string;
+    middle_name?: string;
+    last_name: string;
+    email: string;
+    phone: string;
+    address: UsAccountAddress;
+    birth_date: string;
+    account_number?: string;
+    routing_number?: string;
+}
+/**
+ * @internal
+ * TOS link response
+ */
+export interface TosLinkResponse {
+    result: {
+        url: string;
+    };
+    req_id: string;
+}
 /**
  * @internal
  * Update account request body

package/dist/polygon/polygon-client.d.ts

@@ -1,6 +1,32 @@
 import { BaseClient } from '@bloque/sdk-core';
-import type { CreatePolygonAccountParams, PolygonAccount, UpdatePolygonMetadataParams } from './types';
+import type { CreateAccountOptions } from '../types';
+import type { CreatePolygonAccountParams, ListPolygonAccountsParams, ListPolygonAccountsResult, PolygonAccount, UpdatePolygonMetadataParams } from './types';
 export declare class PolygonClient extends BaseClient {
+    /**
+     * List polygon accounts
+     *
+     * Retrieves a list of polygon accounts, optionally filtered by holder URN or specific account URN.
+     *
+     * @param params - List parameters (optional)
+     * @returns Promise resolving to list of polygon accounts
+     *
+     * @example
+     * ```typescript
+     * // List all polygon accounts for the authenticated holder
+     * const result = await bloque.accounts.polygon.list();
+     *
+     * // List polygon accounts for a specific holder
+     * const result = await bloque.accounts.polygon.list({
+     *   holderUrn: 'did:bloque:bloque-root:nestor'
+     * });
+     *
+     * // Get a specific polygon account
+     * const result = await bloque.accounts.polygon.list({
+     *   urn: 'did:bloque:account:polygon:0x05B10c9B6241b73fc8c906fB7979eFc7764AB731'
+     * });
+     * ```
+     */
+    list(params?: ListPolygonAccountsParams): Promise<ListPolygonAccountsResult>;
     /**
      * Create a new polygon account
      *
@@ -8,14 +34,23 @@ export declare class PolygonClient extends BaseClient {
      * They're created automatically without requiring additional input.
      *
      * @param params - Polygon account creation parameters
+     * @param options - Creation options (optional)
      * @returns Promise resolving to the created polygon account
      *
      * @example
      * ```typescript
+     * // Create without waiting
      * const account = await bloque.accounts.polygon.create();
+     *
+     * // Create and wait for active status
+     * const account = await bloque.accounts.polygon.create({}, { waitLedger: true });
      * ```
      */
-    create(params?: CreatePolygonAccountParams): Promise<PolygonAccount>;
+    create(params?: CreatePolygonAccountParams, options?: CreateAccountOptions): Promise<PolygonAccount>;
+    /**
+     * Private method to poll account status until it becomes active
+     */
+    private _waitForActiveStatus;
     /**
      * Update polygon account metadata
      *

package/dist/polygon/types.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Parameters for listing polygon accounts
+ */
+export interface ListPolygonAccountsParams {
+    /**
+     * URN of the account holder (user or organization) to filter by
+     * @example "did:bloque:bloque-root:nestor"
+     */
+    holderUrn?: string;
+    /**
+     * URN of a specific polygon account to retrieve
+     * @example "did:bloque:account:polygon:0x05B10c9B6241b73fc8c906fB7979eFc7764AB731"
+     */
+    urn?: string;
+}
+/**
+ * Result of listing polygon accounts
+ */
+export interface ListPolygonAccountsResult {
+    /** Array of polygon accounts with balance information */
+    accounts: PolygonAccount[];
+}
 /**
  * Parameters for creating a polygon account
  */
@@ -89,4 +111,13 @@ export interface PolygonAccount {
      * Last update timestamp
      */
     updatedAt: string;
+    /**
+     * Token balances (optional, included in list responses and after creation)
+     */
+    balance?: Record<string, {
+        current: string;
+        pending: string;
+        in: string;
+        out: string;
+    }>;
 }

package/dist/types.d.ts

@@ -1,6 +1,22 @@
 /**
  * Public types for @bloque/sdk-accounts
  */
+/**
+ * Options for account creation
+ */
+export interface CreateAccountOptions {
+    /**
+     * If true, wait for the account to become active before returning
+     * This will poll the account status every second until it's active
+     * @default false
+     */
+    waitLedger?: boolean;
+    /**
+     * Maximum time to wait in milliseconds (only applies when waitLedger is true)
+     * @default 60000 (60 seconds)
+     */
+    timeout?: number;
+}
 /**
  * Supported asset types for transfers and movements
  */
@@ -46,3 +62,80 @@ export interface TransferResult {
     /** Human-readable message about the transfer status */
     message: string;
 }
+/**
+ * Account status
+ */
+export type AccountStatus = 'active' | 'disabled' | 'frozen' | 'deleted' | 'creation_in_progress' | 'creation_failed';
+/**
+ * Account medium/type
+ */
+export type AccountMedium = 'bancolombia' | 'card' | 'virtual' | 'polygon' | 'us-account';
+/**
+ * Token balance information
+ */
+export interface TokenBalance {
+    /** Current balance */
+    current: string;
+    /** Pending balance */
+    pending: string;
+    /** Incoming amount */
+    in: string;
+    /** Outgoing amount */
+    out: string;
+}
+/**
+ * Generic account response
+ * Details type varies based on account medium
+ */
+export interface Account<TDetails = unknown> {
+    /** Unique account identifier */
+    id: string;
+    /** Unique resource name for the account */
+    urn: string;
+    /** Account type/medium */
+    medium: AccountMedium;
+    /** Account-specific details (structure varies by medium) */
+    details: TDetails;
+    /** Ledger account ID */
+    ledgerId: string;
+    /** Account status */
+    status: AccountStatus;
+    /** Owner URN */
+    ownerUrn: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Webhook URL (if configured) */
+    webhookUrl: string | null;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    /** Token balances by asset */
+    balance: Record<string, TokenBalance>;
+}
+/**
+ * Parameters for listing accounts
+ */
+export interface ListAccountsParams {
+    /**
+     * URN of the account holder (user or organization) to filter by
+     * @example "did:bloque:bloque-root:nestor"
+     */
+    holderUrn?: string;
+    /**
+     * Specific account URN to retrieve
+     * @example "did:bloque:account:card:usr-123:crd-456"
+     */
+    urn?: string;
+    /**
+     * Account medium/type to filter by
+     */
+    medium?: AccountMedium;
+}
+/**
+ * Result of listing accounts
+ */
+export interface ListAccountsResult {
+    /** Array of accounts */
+    accounts: Account[];
+}

package/dist/us/types.d.ts

@@ -0,0 +1,257 @@
+import type { TokenBalance, UsAccountType } from '../internal/wire-types';
+/**
+ * Address information for US account creation
+ */
+export interface UsAccountAddress {
+    /**
+     * Street address line 1
+     * @example "456 Wall Street"
+     */
+    streetLine1: string;
+    /**
+     * Street address line 2 (optional)
+     * @example "Suite 789"
+     */
+    streetLine2?: string;
+    /**
+     * City
+     * @example "New York"
+     */
+    city: string;
+    /**
+     * State code (2 letters)
+     * @example "NY"
+     */
+    state: string;
+    /**
+     * Postal code
+     * @example "10005"
+     */
+    postalCode: string;
+    /**
+     * Country code (2 letters)
+     * @example "US"
+     */
+    country: string;
+}
+/**
+ * Parameters for creating a US account
+ */
+export interface CreateUsAccountParams {
+    /**
+     * URN of the account holder (user or organization)
+     * @internal - Not exposed in public documentation
+     */
+    holderUrn?: string;
+    /**
+     * Account type (individual or business)
+     * @example "individual"
+     */
+    type: UsAccountType;
+    /**
+     * First name
+     * @example "Robert"
+     */
+    firstName: string;
+    /**
+     * Middle name (optional)
+     * @example "James"
+     */
+    middleName?: string;
+    /**
+     * Last name
+     * @example "Johnson"
+     */
+    lastName: string;
+    /**
+     * Email address
+     * @example "robert.johnson@example.com"
+     */
+    email: string;
+    /**
+     * Phone number with country code
+     * @example "+12125551234"
+     */
+    phone: string;
+    /**
+     * Address information
+     */
+    address: UsAccountAddress;
+    /**
+     * Birth date in YYYY-MM-DD format
+     * @example "1985-03-15"
+     */
+    birthDate: string;
+    /**
+     * Tax identification number (SSN for individuals, EIN for businesses)
+     * @example "123-45-6789"
+     */
+    taxIdentificationNumber: string;
+    /**
+     * Government ID issuing country (2-letter code)
+     * @example "US"
+     */
+    govIdCountry: string;
+    /**
+     * Base64-encoded image of government ID front
+     */
+    govIdImageFront: string;
+    /**
+     * Signed agreement ID obtained from getTosLink
+     * @example "0d139f8e-14b0-4540-92ba-4e66c619b533"
+     */
+    signedAgreementId: string;
+    /**
+     * Webhook URL to receive account events
+     */
+    webhookUrl?: string;
+    /**
+     * Ledger account ID to associate with this account
+     */
+    ledgerId?: string;
+    /**
+     * Custom metadata to associate with the account
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for getting TOS link
+ */
+export interface GetTosLinkParams {
+    /**
+     * Redirect URI after user accepts terms of service
+     * @example "https://myapp.com/callback"
+     */
+    redirectUri: string;
+}
+/**
+ * Result of getting TOS link
+ */
+export interface TosLinkResult {
+    /**
+     * URL to redirect user to accept terms of service
+     * @example "https://dashboard.bridge.xyz/accept-terms-of-service?session_token=4d5d8c45-9feb-422a-bb5e-0fd32e3b3c53"
+     */
+    url: string;
+}
+/**
+ * Parameters for listing US accounts
+ */
+export interface ListUsAccountsParams {
+    /**
+     * URN of the account holder (user or organization) to filter by
+     * @example "did:bloque:bloque-root:nestor"
+     */
+    holderUrn?: string;
+    /**
+     * URN of a specific US account to retrieve
+     * @example "did:bloque:account:us-account:usr-123:us-456"
+     */
+    urn?: string;
+}
+/**
+ * Result of listing US accounts
+ */
+export interface ListUsAccountsResult {
+    /** Array of US accounts with balance information */
+    accounts: UsAccount[];
+}
+/**
+ * Parameters for updating US account metadata
+ */
+export interface UpdateUsMetadataParams {
+    /**
+     * URN of the US account to update
+     * @example "did:bloque:mediums:us-account:account:123e4567"
+     */
+    urn: string;
+    /**
+     * Metadata to update
+     */
+    metadata: Record<string, unknown>;
+}
+/**
+ * US account information
+ */
+export interface UsAccount {
+    /**
+     * Unique resource name for the US account
+     */
+    urn: string;
+    /**
+     * US account ID
+     */
+    id: string;
+    /**
+     * Account type (individual or business)
+     */
+    type: UsAccountType;
+    /**
+     * First name
+     */
+    firstName: string;
+    /**
+     * Middle name (if provided)
+     */
+    middleName?: string;
+    /**
+     * Last name
+     */
+    lastName: string;
+    /**
+     * Email address
+     */
+    email: string;
+    /**
+     * Phone number
+     */
+    phone: string;
+    /**
+     * Address information
+     */
+    address: UsAccountAddress;
+    /**
+     * Birth date in YYYY-MM-DD format
+     */
+    birthDate: string;
+    /**
+     * Bank account number (if available)
+     */
+    accountNumber?: string;
+    /**
+     * Bank routing number (if available)
+     */
+    routingNumber?: string;
+    /**
+     * Current status of the account
+     */
+    status: 'active' | 'disabled' | 'frozen' | 'deleted' | 'creation_in_progress' | 'creation_failed';
+    /**
+     * Owner URN
+     */
+    ownerUrn: string;
+    /**
+     * Ledger account ID associated with this account
+     */
+    ledgerId: string;
+    /**
+     * Webhook URL (if configured)
+     */
+    webhookUrl: string | null;
+    /**
+     * Custom metadata
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Creation timestamp
+     */
+    createdAt: string;
+    /**
+     * Last update timestamp
+     */
+    updatedAt: string;
+    /**
+     * Token balances (only included in list responses)
+     */
+    balance?: Record<string, TokenBalance>;
+}

package/dist/us/us-client.d.ts

@@ -0,0 +1,170 @@
+import { BaseClient } from '@bloque/sdk-core';
+import type { CreateAccountOptions } from '../types';
+import type { CreateUsAccountParams, GetTosLinkParams, ListUsAccountsParams, ListUsAccountsResult, TosLinkResult, UpdateUsMetadataParams, UsAccount } from './types';
+export declare class UsClient extends BaseClient {
+    /**
+     * Get Terms of Service acceptance link
+     *
+     * This method generates a URL where users can accept the terms of service
+     * required for US account creation. After acceptance, a signed_agreement_id
+     * will be provided which is required for account creation.
+     *
+     * @param params - TOS link parameters
+     * @returns Promise resolving to the TOS acceptance URL
+     *
+     * @example
+     * ```typescript
+     * const tosLink = await bloque.accounts.us.getTosLink({
+     *   redirectUri: 'https://myapp.com/callback'
+     * });
+     *
+     * // Redirect user to tosLink.url
+     * // After acceptance, extract signed_agreement_id from callback
+     * ```
+     */
+    getTosLink(params: GetTosLinkParams): Promise<TosLinkResult>;
+    /**
+     * Create a new US bank account
+     *
+     * Creates a US bank account after the user has accepted the terms of service.
+     * You must first call getTosLink to obtain a signed_agreement_id.
+     *
+     * @param params - US account creation parameters
+     * @param options - Creation options (optional)
+     * @returns Promise resolving to the created US account
+     *
+     * @example
+     * ```typescript
+     * // First, get TOS link and have user accept
+     * const tosLink = await bloque.accounts.us.getTosLink({
+     *   redirectUri: 'https://myapp.com/callback'
+     * });
+     *
+     * // After user accepts, create account with signed_agreement_id
+     * const account = await bloque.accounts.us.create({
+     *   type: 'individual',
+     *   firstName: 'Robert',
+     *   middleName: 'James',
+     *   lastName: 'Johnson',
+     *   email: 'robert.johnson@example.com',
+     *   phone: '+12125551234',
+     *   address: {
+     *     streetLine1: '456 Wall Street',
+     *     streetLine2: 'Suite 789',
+     *     city: 'New York',
+     *     state: 'NY',
+     *     postalCode: '10005',
+     *     country: 'US'
+     *   },
+     *   birthDate: '1985-03-15',
+     *   taxIdentificationNumber: '123-45-6789',
+     *   govIdCountry: 'US',
+     *   govIdImageFront: 'base64_encoded_image',
+     *   signedAgreementId: '0d139f8e-14b0-4540-92ba-4e66c619b533'
+     * });
+     *
+     * // Create and wait for active status
+     * const account = await bloque.accounts.us.create({
+     *   // ... params
+     * }, { waitLedger: true });
+     * ```
+     */
+    create(params: CreateUsAccountParams, options?: CreateAccountOptions): Promise<UsAccount>;
+    /**
+     * List US bank accounts
+     *
+     * Retrieves a list of US bank accounts, optionally filtered by holder URN or specific account URN.
+     *
+     * @param params - List parameters (optional)
+     * @returns Promise resolving to list of US accounts with balances
+     *
+     * @example
+     * ```typescript
+     * // List all US accounts for the authenticated holder
+     * const result = await bloque.accounts.us.list();
+     *
+     * // List US accounts for a specific holder
+     * const result = await bloque.accounts.us.list({
+     *   holderUrn: 'did:bloque:bloque-root:nestor'
+     * });
+     *
+     * // Get a specific US account
+     * const result = await bloque.accounts.us.list({
+     *   urn: 'did:bloque:account:us-account:usr-123:us-456'
+     * });
+     * ```
+     */
+    list(params?: ListUsAccountsParams): Promise<ListUsAccountsResult>;
+    /**
+     * Update US account metadata
+     *
+     * @param params - Metadata update parameters
+     * @returns Promise resolving to the updated US account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.us.updateMetadata({
+     *   urn: 'did:bloque:mediums:us-account:account:123',
+     *   metadata: {
+     *     updated_by: 'admin',
+     *     update_reason: 'customer_request'
+     *   }
+     * });
+     * ```
+     */
+    updateMetadata(params: UpdateUsMetadataParams): Promise<UsAccount>;
+    /**
+     * Activate a US account
+     *
+     * @param urn - US account URN
+     * @returns Promise resolving to the updated US account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.us.activate(
+     *   'did:bloque:mediums:us-account:account:123'
+     * );
+     * ```
+     */
+    activate(urn: string): Promise<UsAccount>;
+    /**
+     * Freeze a US account
+     *
+     * @param urn - US account URN
+     * @returns Promise resolving to the updated US account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.us.freeze(
+     *   'did:bloque:mediums:us-account:account:123'
+     * );
+     * ```
+     */
+    freeze(urn: string): Promise<UsAccount>;
+    /**
+     * Disable a US account
+     *
+     * @param urn - US account URN
+     * @returns Promise resolving to the updated US account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.us.disable(
+     *   'did:bloque:mediums:us-account:account:123'
+     * );
+     * ```
+     */
+    disable(urn: string): Promise<UsAccount>;
+    /**
+     * Private method to poll account status until it becomes active
+     */
+    private _waitForActiveStatus;
+    /**
+     * Private method to update account status
+     */
+    private _updateStatus;
+    /**
+     * Private method to map API response to UsAccount
+     */
+    private _mapAccountResponse;
+}

package/dist/virtual/types.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Parameters for listing virtual accounts
+ */
+export interface ListVirtualAccountsParams {
+    /**
+     * URN of the account holder (user or organization) to filter by
+     * @example "did:bloque:bloque-root:nestor"
+     */
+    holderUrn?: string;
+    /**
+     * URN of a specific virtual account to retrieve
+     * @example "did:bloque:account:virtual:275d10a2-0854-4081-9d61-ea506e917335"
+     */
+    urn?: string;
+}
+/**
+ * Result of listing virtual accounts
+ */
+export interface ListVirtualAccountsResult {
+    /** Array of virtual accounts with balance information */
+    accounts: VirtualAccount[];
+}
 /**
  * Parameters for creating a virtual account
  */
@@ -101,4 +123,13 @@ export interface VirtualAccount {
      * Last update timestamp
      */
     updatedAt: string;
+    /**
+     * Token balances (optional, included in list responses and after creation)
+     */
+    balance?: Record<string, {
+        current: string;
+        pending: string;
+        in: string;
+        out: string;
+    }>;
 }

package/dist/virtual/virtual-client.d.ts

@@ -1,6 +1,32 @@
 import { BaseClient } from '@bloque/sdk-core';
-import type { CreateVirtualAccountParams, UpdateVirtualMetadataParams, VirtualAccount } from './types';
+import type { CreateAccountOptions } from '../types';
+import type { CreateVirtualAccountParams, ListVirtualAccountsParams, ListVirtualAccountsResult, UpdateVirtualMetadataParams, VirtualAccount } from './types';
 export declare class VirtualClient extends BaseClient {
+    /**
+     * List virtual accounts
+     *
+     * Retrieves a list of virtual accounts, optionally filtered by holder URN or specific account URN.
+     *
+     * @param params - List parameters (optional)
+     * @returns Promise resolving to list of virtual accounts
+     *
+     * @example
+     * ```typescript
+     * // List all virtual accounts for the authenticated holder
+     * const result = await bloque.accounts.virtual.list();
+     *
+     * // List virtual accounts for a specific holder
+     * const result = await bloque.accounts.virtual.list({
+     *   holderUrn: 'did:bloque:bloque-root:nestor'
+     * });
+     *
+     * // Get a specific virtual account
+     * const result = await bloque.accounts.virtual.list({
+     *   urn: 'did:bloque:account:virtual:275d10a2-0854-4081-9d61-ea506e917335'
+     * });
+     * ```
+     */
+    list(params?: ListVirtualAccountsParams): Promise<ListVirtualAccountsResult>;
     /**
      * Create a new virtual account
      *
@@ -8,17 +34,29 @@ export declare class VirtualClient extends BaseClient {
      * They're useful for development and testing purposes.
      *
      * @param params - Virtual account creation parameters
+     * @param options - Creation options (optional)
      * @returns Promise resolving to the created virtual account
      *
      * @example
      * ```typescript
+     * // Create without waiting
      * const account = await bloque.accounts.virtual.create({
      *   firstName: 'John',
      *   lastName: 'Doe'
      * });
+     *
+     * // Create and wait for active status
+     * const account = await bloque.accounts.virtual.create({
+     *   firstName: 'John',
+     *   lastName: 'Doe'
+     * }, { waitLedger: true });
      * ```
      */
-    create(params: CreateVirtualAccountParams): Promise<VirtualAccount>;
+    create(params: CreateVirtualAccountParams, options?: CreateAccountOptions): Promise<VirtualAccount>;
+    /**
+     * Private method to poll account status until it becomes active
+     */
+    private _waitForActiveStatus;
     /**
      * Update virtual account metadata
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloque/sdk-accounts",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "type": "module",
   "keywords": [
     "bloque",
@@ -36,6 +36,6 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@bloque/sdk-core": "0.0.25"
+    "@bloque/sdk-core": "0.0.27"
   }
 }