@bloque/sdk-accounts 0.0.23 → 0.0.24

package/dist/{client.d.ts → accounts-client.d.ts}

@@ -1,8 +1,9 @@
 import type { HttpClient } from '@bloque/sdk-core';
 import { BaseClient } from '@bloque/sdk-core';
-import type { TransferParams, TransferResult } from './api-types';
-import { BancolombiaClient } from './bancolombia/client';
-import { CardClient } from './card/client';
+import { BancolombiaClient } from './bancolombia/bancolombia-client';
+import { CardClient } from './card/card-client';
+import type { TransferParams, TransferResult } from './types';
+import { VirtualClient } from './virtual/virtual-client';
 /**
  * Accounts client for managing financial accounts and payment methods
  *
@@ -16,6 +17,7 @@ import { CardClient } from './card/client';
 export declare class AccountsClient extends BaseClient {
     readonly bancolombia: BancolombiaClient;
     readonly card: CardClient;
+    readonly virtual: VirtualClient;
     constructor(httpClient: HttpClient);
     /**
      * Transfer funds between accounts

package/dist/bancolombia/{client.d.ts → bancolombia-client.d.ts}

@@ -10,12 +10,11 @@ export declare class BancolombiaClient extends BaseClient {
      * @example
      * ```typescript
      * const account = await bloque.accounts.bancolombia.create({
-     *   urn: 'did:bloque:user:123',
      *   name: 'Main Account'
      * });
      * ```
      */
-    create(params: CreateBancolombiaAccountParams): Promise<BancolombiaAccount>;
+    create(params?: CreateBancolombiaAccountParams): Promise<BancolombiaAccount>;
     /**
      * Update Bancolombia account metadata
      *

package/dist/bancolombia/types.d.ts

@@ -4,7 +4,7 @@ export interface CreateBancolombiaAccountParams {
      *
      * @example "did:bloque:user:123e4567"
      */
-    urn: string;
+    holderUrn?: string;
     /**
      * Display name for the card
      */

package/dist/card/{client.d.ts → card-client.d.ts}

@@ -1,5 +1,5 @@
 import { BaseClient } from '@bloque/sdk-core';
-import type { TokenBalance } from '../api-types';
+import type { TokenBalance } from '../internal/wire-types';
 import type { CardAccount, CardMovement, CreateCardParams, GetBalanceParams, ListCardParams, ListMovementsParams, UpdateCardMetadataParams } from './types';
 export declare class CardClient extends BaseClient {
     /**
@@ -11,12 +11,11 @@ export declare class CardClient extends BaseClient {
      * @example
      * ```typescript
      * const card = await bloque.accounts.card.create({
-     *   urn: 'did:bloque:user:123',
      *   name: 'My Card',
      * });
      * ```
      */
-    create(params: CreateCardParams): Promise<CardAccount>;
+    create(params?: CreateCardParams): Promise<CardAccount>;
     /**
      * List card accounts for a holder
      *
@@ -25,9 +24,7 @@ export declare class CardClient extends BaseClient {
      *
      * @example
      * ```typescript
-     * const cards = await bloque.accounts.card.list({
-     *   holderUrn: 'did:bloque:bloque-whatsapp:573023348486',
-     * });
+     * const cards = await bloque.accounts.card.list();
      * ```
      */
     list(params?: ListCardParams): Promise<CardAccount[]>;

package/dist/card/types.d.ts

@@ -1,11 +1,12 @@
-import type { CardType, SupportedAsset, TokenBalance, Transaction } from '../api-types';
+import type { CardType, TokenBalance, Transaction } from '../internal/wire-types';
+import type { SupportedAsset } from '../types';
 export interface ListCardParams {
     /**
-     * URN of the account holder to filter by
+     * URN of the account holder (user or organization)
      *
-     * @example "did:bloque:bloque-whatsapp:573023348486"
+     * @example "did:bloque:user:123e4567"
      */
-    holderUrn: string;
+    holderUrn?: string;
 }
 export interface ListMovementsParams {
     /**
@@ -67,7 +68,7 @@ export interface CreateCardParams {
      *
      * @example "did:bloque:user:123e4567"
      */
-    urn: string;
+    holderUrn?: string;
     /**
      * Display name for the card
      */

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=(e,t)=>{for(var a in t)__webpack_require__.o(t,a)&&!__webpack_require__.o(e,a)&&Object.defineProperty(e,a,{enumerable:!0,get:t[a]})},__webpack_require__.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),__webpack_require__.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{AccountsClient:()=>AccountsClient,CardClient:()=>CardClient,BancolombiaClient:()=>BancolombiaClient});const sdk_core_namespaceObject=require("@bloque/sdk-core");class BancolombiaClient extends sdk_core_namespaceObject.BaseClient{async create(e){let t={holder_urn:e.urn,webhook_url:e.webhookUrl,ledger_account_id:e.ledgerId,input:{},metadata:{source:"sdk-typescript",name:e.name,...e.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/bancolombia",body:t});return this._mapAccountResponse(a.result.account)}async updateMetadata(e){let t={metadata:e.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${e.urn}`,body:t});return this._mapAccountResponse(a.result.account)}async updateName(e,t){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${e}`,body:{metadata:{name:t}}});return this._mapAccountResponse(a.result.account)}async activate(e){return this._updateStatus(e,"active")}async freeze(e){return this._updateStatus(e,"frozen")}async disable(e){return this._updateStatus(e,"disabled")}async _updateStatus(e,t){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${e}`,body:{status:t}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(e){return{urn:e.urn,id:e.id,referenceCode:e.details.reference_code,status:e.status,ownerUrn:e.owner_urn,ledgerId:e.ledger_account_id,webhookUrl:e.webhook_url,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}}class CardClient extends sdk_core_namespaceObject.BaseClient{async create(e){let t={holder_urn:e.urn,webhook_url:e.webhookUrl,ledger_account_id:e.ledgerId,input:{create:{card_type:"VIRTUAL"}},metadata:{source:"sdk-typescript",name:e.name,...e.metadata}},a=await this.httpClient.request({method:"POST",path:"/api/mediums/card",body:t});return this._mapAccountResponse(a.result.account)}async list(e){let t=new URLSearchParams({holder_urn:e?.holderUrn||this.httpClient.config.urn||"",medium:"card"});return(await this.httpClient.request({method:"GET",path:`/api/accounts?${t.toString()}`})).accounts.map(e=>({urn:e.urn,id:e.id,lastFour:e.details.card_last_four,productType:e.details.card_product_type,status:e.status,cardType:e.details.card_type,detailsUrl:e.details.card_url_details,ownerUrn:e.owner_urn,ledgerId:e.ledger_account_id,webhookUrl:e.webhook_url,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at,balance:e.balance}))}async movements(e){let t=new URLSearchParams,a=e.asset||"DUSD/6";if("DUSD/6"!==a&&"KSM/12"!==a)throw Error("Invalid asset type. Supported assets are USD and KSM.");t.set("asset",a),void 0!==e.limit&&t.set("limit",e.limit.toString()),e.before&&t.set("before",e.before),e.after&&t.set("after",e.after),e.reference&&t.set("reference",e.reference),e.direction&&t.set("direction",e.direction);let r=t.toString(),s=`/api/accounts/${e.urn}/movements${r?`?${r}`:""}`;return(await this.httpClient.request({method:"GET",path:s})).transactions}async balance(e){return(await this.httpClient.request({method:"GET",path:`/api/accounts/${e.urn}/balance`})).balance}async updateMetadata(e){let t={metadata:e.metadata},a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${e.urn}`,body:t});return this._mapAccountResponse(a.result.account)}async updateName(e,t){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${e}`,body:{metadata:{name:t}}});return this._mapAccountResponse(a.result.account)}async activate(e){return this._updateStatus(e,"active")}async freeze(e){return this._updateStatus(e,"frozen")}async disable(e){return this._updateStatus(e,"disabled")}async _updateStatus(e,t){let a=await this.httpClient.request({method:"PATCH",path:`/api/accounts/${e}`,body:{status:t}});return this._mapAccountResponse(a.result.account)}_mapAccountResponse(e){return{urn:e.urn,id:e.id,lastFour:e.details.card_last_four,productType:e.details.card_product_type,status:e.status,cardType:e.details.card_type,detailsUrl:e.details.card_url_details,ownerUrn:e.owner_urn,ledgerId:e.ledger_account_id,webhookUrl:e.webhook_url,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}}class AccountsClient extends sdk_core_namespaceObject.BaseClient{bancolombia;card;constructor(e){super(e),this.bancolombia=new BancolombiaClient(this.httpClient),this.card=new CardClient(this.httpClient)}async transfer(e){let t=e.asset||"DUSD/6";if("DUSD/6"!==t&&"KSM/12"!==t)throw Error("Invalid asset type. Supported assets are USD and KSM.");let a={destination_account_urn:e.destinationUrn,amount:e.amount,asset:t,metadata:e.metadata},r=await this.httpClient.request({method:"POST",path:`/api/accounts/${e.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,__webpack_exports__)-1===["AccountsClient","BancolombiaClient","CardClient"].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,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 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;virtual;constructor(t){super(t),this.bancolombia=new BancolombiaClient(this.httpClient),this.card=new CardClient(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.VirtualClient=__webpack_exports__.VirtualClient,__webpack_exports__)-1===["AccountsClient","BancolombiaClient","CardClient","VirtualClient"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.d.ts

@@ -1,5 +1,8 @@
-export * from './bancolombia/client';
+export * from './accounts-client';
+export * from './bancolombia/bancolombia-client';
 export * from './bancolombia/types';
-export * from './card/client';
+export * from './card/card-client';
 export * from './card/types';
-export * from './client';
+export * from './types';
+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.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.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.config.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 r extends t{bancolombia;card;constructor(t){super(t),this.bancolombia=new e(this.httpClient),this.card=new a(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}}}export{r as AccountsClient,e as BancolombiaClient,a as CardClient};
+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 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 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 s extends t{bancolombia;card;virtual;constructor(t){super(t),this.bancolombia=new e(this.httpClient),this.card=new a(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},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}}}export{s as AccountsClient,e as BancolombiaClient,a as CardClient,r as VirtualClient};

package/dist/{api-types.d.ts → internal/wire-types.d.ts}

@@ -1,8 +1,22 @@
+/**
+ * @internal
+ * Wire types for API communication (snake_case format)
+ * These types represent the raw API request/response format
+ * and should not be used directly by SDK consumers.
+ */
+/**
+ * @internal
+ * Account status from API
+ */
 export type AccountStatus = 'active' | 'disabled' | 'frozen' | 'deleted' | 'creation_in_progress' | 'creation_failed';
-interface Account<TDetails = unknown> {
+/**
+ * @internal
+ * Raw account from API
+ */
+export interface Account<TDetails = unknown> {
     id: string;
     urn: string;
-    medium: 'bancolombia' | 'card';
+    medium: 'bancolombia' | 'card' | 'virtual';
     details: TDetails;
     ledger_account_id: string;
     status: AccountStatus;
@@ -12,7 +26,15 @@ interface Account<TDetails = unknown> {
     webhook_url: string | null;
     metadata?: Record<string, unknown>;
 }
+/**
+ * @internal
+ * Card type enum
+ */
 export type CardType = 'VIRTUAL' | 'PHYSICAL';
+/**
+ * @internal
+ * Create account request body
+ */
 export interface CreateAccountRequest<TInput = unknown> {
     holder_urn: string;
     ledger_account_id?: string;
@@ -20,17 +42,29 @@ export interface CreateAccountRequest<TInput = unknown> {
     metadata?: Record<string, unknown>;
     webhook_url?: string;
 }
+/**
+ * @internal
+ * Card account input for creation
+ */
 export type CreateCardAccountInput = {
     create: {
         card_type: CardType;
     };
 };
+/**
+ * @internal
+ * Create account response
+ */
 export interface CreateAccountResponse<TDetails = unknown> {
     result: {
         account: Account<TDetails>;
     };
     req_id: string;
 }
+/**
+ * @internal
+ * Card details from API
+ */
 export type CardDetails = {
     id: string;
     email: string;
@@ -45,35 +79,80 @@ export type CardDetails = {
     card_type: CardType;
     user_id: string;
 };
+/**
+ * @internal
+ * Bancolombia details from API
+ */
 export type BancolombiaDetails = {
     id: string;
     reference_code: string;
     payment_agreement_code: string;
     network: string[];
 };
+/**
+ * @internal
+ * Virtual account input for creation
+ */
+export type CreateVirtualAccountInput = {
+    first_name: string;
+    last_name: string;
+};
+/**
+ * @internal
+ * Virtual account details from API
+ */
+export type VirtualDetails = {
+    id: string;
+    first_name: string;
+    last_name: string;
+};
+/**
+ * @internal
+ * Update account request body
+ */
 export interface UpdateAccountRequest<TInput = unknown> {
     input?: TInput;
     metadata?: Record<string, unknown>;
     status?: AccountStatus;
 }
+/**
+ * @internal
+ * Update account response
+ */
 export interface UpdateAccountResponse<TDetails = unknown> {
     result: {
         account: Account<TDetails>;
     };
     req_id: string;
 }
+/**
+ * @internal
+ * Token balance from API
+ */
 export interface TokenBalance {
     current: string;
     pending: string;
     in: string;
     out: string;
 }
+/**
+ * @internal
+ * Account with balance from API
+ */
 export interface AccountWithBalance<TDetails = unknown> extends Account<TDetails> {
     balance: Record<string, TokenBalance>;
 }
+/**
+ * @internal
+ * List accounts response
+ */
 export interface ListAccountsResponse<TDetails = unknown> {
     accounts: AccountWithBalance<TDetails>[];
 }
+/**
+ * @internal
+ * Transaction metadata from API
+ */
 export interface TransactionMetadata {
     amount?: string;
     asset_type?: string;
@@ -103,10 +182,18 @@ export interface TransactionMetadata {
     user_id?: string;
     [key: string]: unknown;
 }
+/**
+ * @internal
+ * Transaction details from API
+ */
 export interface TransactionDetails {
     metadata: TransactionMetadata;
     type: string;
 }
+/**
+ * @internal
+ * Transaction from API
+ */
 export interface Transaction {
     amount: string;
     asset: string;
@@ -118,51 +205,34 @@ export interface Transaction {
     details: TransactionDetails;
     created_at: string;
 }
+/**
+ * @internal
+ * List movements response
+ */
 export interface ListMovementsResponse {
     transactions: Transaction[];
 }
+/**
+ * @internal
+ * Get balance response
+ */
 export interface GetBalanceResponse {
     balance: Record<string, TokenBalance>;
 }
-export type SupportedAsset = 'DUSD/6' | 'KSM/12';
-export interface TransferParams {
-    /**
-     * URN of the source account
-     * @example "did:bloque:account:card:usr-123:crd-456"
-     */
-    sourceUrn: string;
-    /**
-     * URN of the destination account
-     * @example "did:bloque:account:virtual:acc-67890"
-     */
-    destinationUrn: string;
-    /**
-     * Amount to transfer
-     * @example "1000000000000"
-     */
-    amount: string;
-    /**
-     * Asset to transfer
-     * @example "USD"
-     */
-    asset: SupportedAsset;
-    /**
-     * Optional metadata for the transfer
-     * @example { reference: "payment-123", note: "Monthly subscription" }
-     */
-    metadata?: Record<string, unknown>;
-}
+/**
+ * @internal
+ * Transfer request body
+ */
 export interface TransferRequest {
     destination_account_urn: string;
     amount: string;
     asset: string;
     metadata?: Record<string, unknown>;
 }
-export interface TransferResult {
-    queueId: string;
-    status: 'queued' | 'processing' | 'completed' | 'failed';
-    message: string;
-}
+/**
+ * @internal
+ * Transfer response from API
+ */
 export interface TransferResponse {
     result: {
         queue_id: string;
@@ -171,4 +241,3 @@ export interface TransferResponse {
     };
     req_id: string;
 }
-export {};

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Public types for @bloque/sdk-accounts
+ */
+/**
+ * Supported asset types for transfers and movements
+ */
+export type SupportedAsset = 'DUSD/6' | 'KSM/12';
+/**
+ * Parameters for transferring funds between accounts
+ */
+export interface TransferParams {
+    /**
+     * URN of the source account
+     * @example "did:bloque:account:card:usr-123:crd-456"
+     */
+    sourceUrn: string;
+    /**
+     * URN of the destination account
+     * @example "did:bloque:account:virtual:acc-67890"
+     */
+    destinationUrn: string;
+    /**
+     * Amount to transfer (as string to preserve precision)
+     * @example "1000000000000"
+     */
+    amount: string;
+    /**
+     * Asset to transfer
+     * @example "DUSD/6"
+     */
+    asset: SupportedAsset;
+    /**
+     * Optional metadata for the transfer
+     * @example { reference: "payment-123", note: "Monthly subscription" }
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of a transfer operation
+ */
+export interface TransferResult {
+    /** Unique identifier for the queued transfer */
+    queueId: string;
+    /** Current status of the transfer */
+    status: 'queued' | 'processing' | 'completed' | 'failed';
+    /** Human-readable message about the transfer status */
+    message: string;
+}

package/dist/virtual/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Parameters for creating a virtual account
+ */
+export interface CreateVirtualAccountParams {
+    /**
+     * URN of the account holder (user or organization)
+     *
+     * @example "did:bloque:user:123e4567"
+     */
+    holderUrn?: string;
+    /**
+     * Account holder's first name
+     *
+     * @example "John"
+     */
+    firstName: string;
+    /**
+     * Account holder's last name
+     *
+     * @example "Doe"
+     */
+    lastName: string;
+    /**
+     * Ledger account ID to associate with the virtual account
+     * If not provided, a new ledger account will be created automatically
+     */
+    ledgerId?: string;
+    /**
+     * Webhook URL to receive account events
+     */
+    webhookUrl?: string;
+    /**
+     * Custom metadata to attach to the virtual account
+     * Must be a Record<string, string> (all values must be strings)
+     */
+    metadata?: Record<string, string>;
+}
+/**
+ * Parameters for updating virtual account metadata
+ */
+export interface UpdateVirtualMetadataParams {
+    /**
+     * URN of the virtual account to update
+     *
+     * @example "did:bloque:mediums:virtual:account:123e4567"
+     */
+    urn: string;
+    /**
+     * Metadata to update
+     * Note: 'source' is a reserved field and cannot be modified
+     */
+    metadata: Record<string, string> & {
+        source?: never;
+    };
+}
+/**
+ * Virtual account response
+ */
+export interface VirtualAccount {
+    /**
+     * Unique resource name for the virtual account
+     */
+    urn: string;
+    /**
+     * Account ID
+     */
+    id: string;
+    /**
+     * Account holder's first name
+     */
+    firstName: string;
+    /**
+     * Account holder's last name
+     */
+    lastName: string;
+    /**
+     * Account status
+     */
+    status: 'creation_in_progress' | 'active' | 'disabled' | 'frozen' | 'deleted' | 'creation_failed';
+    /**
+     * Owner URN
+     */
+    ownerUrn: string;
+    /**
+     * Ledger account ID associated with the virtual account
+     */
+    ledgerId: string;
+    /**
+     * Webhook URL (if configured)
+     */
+    webhookUrl: string | null;
+    /**
+     * Custom metadata
+     */
+    metadata?: Record<string, string>;
+    /**
+     * Creation timestamp
+     */
+    createdAt: string;
+    /**
+     * Last update timestamp
+     */
+    updatedAt: string;
+}

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

@@ -0,0 +1,90 @@
+import { BaseClient } from '@bloque/sdk-core';
+import type { CreateVirtualAccountParams, UpdateVirtualMetadataParams, VirtualAccount } from './types';
+export declare class VirtualClient extends BaseClient {
+    /**
+     * Create a new virtual account
+     *
+     * Virtual accounts are simple testing accounts requiring only basic personal information.
+     * They're useful for development and testing purposes.
+     *
+     * @param params - Virtual account creation parameters
+     * @returns Promise resolving to the created virtual account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.virtual.create({
+     *   firstName: 'John',
+     *   lastName: 'Doe'
+     * });
+     * ```
+     */
+    create(params: CreateVirtualAccountParams): Promise<VirtualAccount>;
+    /**
+     * Update virtual account metadata
+     *
+     * @param params - Metadata update parameters
+     * @returns Promise resolving to the updated virtual account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.virtual.updateMetadata({
+     *   urn: 'did:bloque:mediums:virtual:account:123',
+     *   metadata: {
+     *     updated_by: 'admin',
+     *     update_reason: 'testing_update'
+     *   }
+     * });
+     * ```
+     */
+    updateMetadata(params: UpdateVirtualMetadataParams): Promise<VirtualAccount>;
+    /**
+     * Activate a virtual account
+     *
+     * @param urn - Virtual account URN
+     * @returns Promise resolving to the updated virtual account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.virtual.activate(
+     *   'did:bloque:mediums:virtual:account:123'
+     * );
+     * ```
+     */
+    activate(urn: string): Promise<VirtualAccount>;
+    /**
+     * Freeze a virtual account
+     *
+     * @param urn - Virtual account URN
+     * @returns Promise resolving to the updated virtual account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.virtual.freeze(
+     *   'did:bloque:mediums:virtual:account:123'
+     * );
+     * ```
+     */
+    freeze(urn: string): Promise<VirtualAccount>;
+    /**
+     * Disable a virtual account
+     *
+     * @param urn - Virtual account URN
+     * @returns Promise resolving to the updated virtual account
+     *
+     * @example
+     * ```typescript
+     * const account = await bloque.accounts.virtual.disable(
+     *   'did:bloque:mediums:virtual:account:123'
+     * );
+     * ```
+     */
+    disable(urn: string): Promise<VirtualAccount>;
+    /**
+     * Private method to update virtual account status
+     */
+    private _updateStatus;
+    /**
+     * Private method to map API response to VirtualAccount
+     */
+    private _mapAccountResponse;
+}

package/package.json

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