@bloque/sdk-swap 0.0.30 → 0.0.32

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__,{SwapClient:()=>SwapClient,PseClient:()=>PseClient});const sdk_core_namespaceObject=require("@bloque/sdk-core");class PseClient extends sdk_core_namespaceObject.BaseClient{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(e=>this._mapBankResponse(e))}}async createTopUp(e){let t={name:"PSE Top-up",description:"PSE Top-up",currency:e.currency,payment_type:"shopping_cart",items:[{name:"PSE Top-up",amount:e.amount,quantity:1}],success_url:e.successUrl,webhook_url:e.webhookUrl},a=await this.httpClient.request({method:"POST",path:"/api/payments",body:t});return{payment:this._mapPaymentResponse(a.payment)}}async initiatePayment(e){let t={payment_urn:e.paymentUrn,payee:{name:e.payee.name,email:e.payee.email,id_type:e.payee.idType,id_number:e.payee.idNumber},person_type:e.personType,bank_code:e.bankCode},a=await this.httpClient.request({method:"POST",path:"/api/payments/pse",body:t});return{paymentId:a.payment_id,status:a.status,message:a.message,amount:a.amount,currency:a.currency,checkoutUrl:a.checkout_url,orderId:a.order_id,orderStatus:a.order_status,createdAt:a.created_at}}_mapBankResponse(e){return{code:e.financial_institution_code,name:e.financial_institution_name}}_mapPaymentResponse(e){return{urn:e.urn,ownerUrn:e.owner_urn,name:e.name,description:e.description,currency:e.currency,amount:e.amount,url:e.url,successUrl:e.success_url,cancelUrl:e.cancel_url,imageUrl:e.image_url,metadata:e.metadata,tax:e.tax,discountCode:e.discount_code,webhookUrl:e.webhook_url,payoutRoute:e.payout_route,summary:{status:e.summary.status},expiresAt:e.expires_at,createdAt:e.created_at,updatedAt:e.updated_at,paymentType:e.payment_type,items:e.items.map(e=>this._mapPaymentItemResponse(e))}}_mapPaymentItemResponse(e){return{name:e.name,amount:e.amount,sku:e.sku,description:e.description,quantity:e.quantity,imageUrl:e.image_url}}}class SwapClient extends sdk_core_namespaceObject.BaseClient{pse;constructor(e){super(e),this.pse=new PseClient(this.httpClient)}async findRates(e){let t=new URLSearchParams,a=JSON.stringify([e.fromAsset,e.toAsset]);t.append("edge",a),t.append("from_medium",JSON.stringify(e.fromMediums)),t.append("to_medium",JSON.stringify(e.toMediums)),void 0!==e.amountSrc&&t.append("amount_src",e.amountSrc),void 0!==e.amountDst&&t.append("amount_dst",e.amountDst),e.sort&&t.append("sort",e.sort),e.sortBy&&t.append("sort_by",e.sortBy);let r=t.toString(),n=`/api/rates?${r}`;return{rates:(await this.httpClient.request({method:"GET",path:n})).rates.map(e=>this._mapRateResponse(e))}}_mapRateResponse(e){return{id:e.id,sig:e.sig,swapSig:e.swap_sig,maker:e.maker,edge:e.edge,fee:{at:e.fee.at,value:e.fee.value,formula:e.fee.formula,components:e.fee.components.map(e=>({at:e.at,name:e.name,type:e.type,value:e.value,percentage:e.percentage,pair:e.pair,amount:e.amount}))},at:e.at,until:e.until,fromMediums:e.from_medium,toMediums:e.to_medium,rate:e.rate,ratio:e.ratio,fromLimits:e.from_limits,toLimits:e.to_limits,createdAt:e.created_at,updatedAt:e.updated_at}}}for(var __rspack_i in exports.PseClient=__webpack_exports__.PseClient,exports.SwapClient=__webpack_exports__.SwapClient,__webpack_exports__)-1===["PseClient","SwapClient"].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=(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__,{SwapClient:()=>SwapClient,PseClient:()=>PseClient});const sdk_core_namespaceObject=require("@bloque/sdk-core");class PseClient extends sdk_core_namespaceObject.BaseClient{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(e=>this._mapBankResponse(e))}}async create(e){let t=this.httpClient.urn;if(!t)throw new sdk_core_namespaceObject.BloqueConfigError("User URN is not available. Please connect to a session first.");let a=e.type??"src",r={taker_urn:t,type:a,rate_sig:e.rateSig,from_medium:"pse",to_medium:e.toMedium,deposit_information:this._mapDepositInformationToWire(e.depositInformation)};"src"===a&&e.amountSrc?r.amount_src=e.amountSrc:"dst"===a&&e.amountDst&&(r.amount_dst=e.amountDst),e.args&&(r.args={bank_code:e.args.bankCode,...e.args.userType&&{user_type:e.args.userType},...e.args.customerEmail&&{customer_email:e.args.customerEmail},...e.args.userLegalIdType&&{user_legal_id_type:e.args.userLegalIdType},...e.args.userLegalId&&{user_legal_id:e.args.userLegalId},...e.args.customerData&&{customer_data:{full_name:e.args.customerData.fullName}}}),e.nodeId&&(r.node_id=e.nodeId),e.metadata&&(r.metadata=e.metadata);let s=await this.httpClient.request({method:"PUT",path:"/api/order",body:r});return{order:this._mapOrderResponse(s.result.order),execution:s.result.execution?this._mapExecutionResult(s.result.execution):void 0,requestId:s.req_id}}_mapBankResponse(e){return{code:e.financial_institution_code,name:e.financial_institution_name}}_mapDepositInformationToWire(e){return{urn:e.urn}}_mapOrderResponse(e){return{id:e.id,orderSig:e.order_sig,rateSig:e.rate_sig,swapSig:e.swap_sig,taker:e.taker,maker:e.maker,fromAsset:e.from_asset,toAsset:e.to_asset,fromMedium:e.from_medium,toMedium:e.to_medium,fromAmount:e.from_amount,toAmount:e.to_amount,at:e.at,graphId:e.graph_id,status:e.status,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}_mapExecutionResult(e){return{nodeId:e.node_id,result:{status:e.result.status,name:e.result.name,description:e.result.description,how:e.result.how,callbackToken:e.result.callback_token}}}}class SwapClient extends sdk_core_namespaceObject.BaseClient{pse;constructor(e){super(e),this.pse=new PseClient(this.httpClient)}async findRates(e){let t=new URLSearchParams,a=JSON.stringify([e.fromAsset,e.toAsset]);t.append("edge",a),t.append("from_medium",JSON.stringify(e.fromMediums)),t.append("to_medium",JSON.stringify(e.toMediums)),void 0!==e.amountSrc&&t.append("amount_src",e.amountSrc),void 0!==e.amountDst&&t.append("amount_dst",e.amountDst),e.sort&&t.append("sort",e.sort),e.sortBy&&t.append("sort_by",e.sortBy);let r=t.toString(),s=`/api/rates?${r}`;return{rates:(await this.httpClient.request({method:"GET",path:s})).rates.map(e=>this._mapRateResponse(e))}}_mapRateResponse(e){return{id:e.id,sig:e.sig,swapSig:e.swap_sig,maker:e.maker,edge:e.edge,fee:{at:e.fee.at,value:e.fee.value,formula:e.fee.formula,components:e.fee.components.map(e=>({at:e.at,name:e.name,type:e.type,value:e.value,percentage:e.percentage,pair:e.pair,amount:e.amount}))},at:e.at,until:e.until,fromMediums:e.from_medium,toMediums:e.to_medium,rate:e.rate,ratio:e.ratio,fromLimits:e.from_limits,toLimits:e.to_limits,createdAt:e.created_at,updatedAt:e.updated_at}}}for(var __rspack_i in exports.PseClient=__webpack_exports__.PseClient,exports.SwapClient=__webpack_exports__.SwapClient,__webpack_exports__)-1===["PseClient","SwapClient"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.js

@@ -1 +1 @@
-import{BaseClient as e}from"@bloque/sdk-core";class t extends e{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(e=>this._mapBankResponse(e))}}async createTopUp(e){let t={name:"PSE Top-up",description:"PSE Top-up",currency:e.currency,payment_type:"shopping_cart",items:[{name:"PSE Top-up",amount:e.amount,quantity:1}],success_url:e.successUrl,webhook_url:e.webhookUrl},a=await this.httpClient.request({method:"POST",path:"/api/payments",body:t});return{payment:this._mapPaymentResponse(a.payment)}}async initiatePayment(e){let t={payment_urn:e.paymentUrn,payee:{name:e.payee.name,email:e.payee.email,id_type:e.payee.idType,id_number:e.payee.idNumber},person_type:e.personType,bank_code:e.bankCode},a=await this.httpClient.request({method:"POST",path:"/api/payments/pse",body:t});return{paymentId:a.payment_id,status:a.status,message:a.message,amount:a.amount,currency:a.currency,checkoutUrl:a.checkout_url,orderId:a.order_id,orderStatus:a.order_status,createdAt:a.created_at}}_mapBankResponse(e){return{code:e.financial_institution_code,name:e.financial_institution_name}}_mapPaymentResponse(e){return{urn:e.urn,ownerUrn:e.owner_urn,name:e.name,description:e.description,currency:e.currency,amount:e.amount,url:e.url,successUrl:e.success_url,cancelUrl:e.cancel_url,imageUrl:e.image_url,metadata:e.metadata,tax:e.tax,discountCode:e.discount_code,webhookUrl:e.webhook_url,payoutRoute:e.payout_route,summary:{status:e.summary.status},expiresAt:e.expires_at,createdAt:e.created_at,updatedAt:e.updated_at,paymentType:e.payment_type,items:e.items.map(e=>this._mapPaymentItemResponse(e))}}_mapPaymentItemResponse(e){return{name:e.name,amount:e.amount,sku:e.sku,description:e.description,quantity:e.quantity,imageUrl:e.image_url}}}class a extends e{pse;constructor(e){super(e),this.pse=new t(this.httpClient)}async findRates(e){let t=new URLSearchParams,a=JSON.stringify([e.fromAsset,e.toAsset]);t.append("edge",a),t.append("from_medium",JSON.stringify(e.fromMediums)),t.append("to_medium",JSON.stringify(e.toMediums)),void 0!==e.amountSrc&&t.append("amount_src",e.amountSrc),void 0!==e.amountDst&&t.append("amount_dst",e.amountDst),e.sort&&t.append("sort",e.sort),e.sortBy&&t.append("sort_by",e.sortBy);let n=t.toString(),s=`/api/rates?${n}`;return{rates:(await this.httpClient.request({method:"GET",path:s})).rates.map(e=>this._mapRateResponse(e))}}_mapRateResponse(e){return{id:e.id,sig:e.sig,swapSig:e.swap_sig,maker:e.maker,edge:e.edge,fee:{at:e.fee.at,value:e.fee.value,formula:e.fee.formula,components:e.fee.components.map(e=>({at:e.at,name:e.name,type:e.type,value:e.value,percentage:e.percentage,pair:e.pair,amount:e.amount}))},at:e.at,until:e.until,fromMediums:e.from_medium,toMediums:e.to_medium,rate:e.rate,ratio:e.ratio,fromLimits:e.from_limits,toLimits:e.to_limits,createdAt:e.created_at,updatedAt:e.updated_at}}}export{t as PseClient,a as SwapClient};
+import{BaseClient as e,BloqueConfigError as t}from"@bloque/sdk-core";class a extends e{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(e=>this._mapBankResponse(e))}}async create(e){let a=this.httpClient.urn;if(!a)throw new t("User URN is not available. Please connect to a session first.");let s=e.type??"src",r={taker_urn:a,type:s,rate_sig:e.rateSig,from_medium:"pse",to_medium:e.toMedium,deposit_information:this._mapDepositInformationToWire(e.depositInformation)};"src"===s&&e.amountSrc?r.amount_src=e.amountSrc:"dst"===s&&e.amountDst&&(r.amount_dst=e.amountDst),e.args&&(r.args={bank_code:e.args.bankCode,...e.args.userType&&{user_type:e.args.userType},...e.args.customerEmail&&{customer_email:e.args.customerEmail},...e.args.userLegalIdType&&{user_legal_id_type:e.args.userLegalIdType},...e.args.userLegalId&&{user_legal_id:e.args.userLegalId},...e.args.customerData&&{customer_data:{full_name:e.args.customerData.fullName}}}),e.nodeId&&(r.node_id=e.nodeId),e.metadata&&(r.metadata=e.metadata);let o=await this.httpClient.request({method:"PUT",path:"/api/order",body:r});return{order:this._mapOrderResponse(o.result.order),execution:o.result.execution?this._mapExecutionResult(o.result.execution):void 0,requestId:o.req_id}}_mapBankResponse(e){return{code:e.financial_institution_code,name:e.financial_institution_name}}_mapDepositInformationToWire(e){return{urn:e.urn}}_mapOrderResponse(e){return{id:e.id,orderSig:e.order_sig,rateSig:e.rate_sig,swapSig:e.swap_sig,taker:e.taker,maker:e.maker,fromAsset:e.from_asset,toAsset:e.to_asset,fromMedium:e.from_medium,toMedium:e.to_medium,fromAmount:e.from_amount,toAmount:e.to_amount,at:e.at,graphId:e.graph_id,status:e.status,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}_mapExecutionResult(e){return{nodeId:e.node_id,result:{status:e.result.status,name:e.result.name,description:e.result.description,how:e.result.how,callbackToken:e.result.callback_token}}}}class s extends e{pse;constructor(e){super(e),this.pse=new a(this.httpClient)}async findRates(e){let t=new URLSearchParams,a=JSON.stringify([e.fromAsset,e.toAsset]);t.append("edge",a),t.append("from_medium",JSON.stringify(e.fromMediums)),t.append("to_medium",JSON.stringify(e.toMediums)),void 0!==e.amountSrc&&t.append("amount_src",e.amountSrc),void 0!==e.amountDst&&t.append("amount_dst",e.amountDst),e.sort&&t.append("sort",e.sort),e.sortBy&&t.append("sort_by",e.sortBy);let s=t.toString(),r=`/api/rates?${s}`;return{rates:(await this.httpClient.request({method:"GET",path:r})).rates.map(e=>this._mapRateResponse(e))}}_mapRateResponse(e){return{id:e.id,sig:e.sig,swapSig:e.swap_sig,maker:e.maker,edge:e.edge,fee:{at:e.fee.at,value:e.fee.value,formula:e.fee.formula,components:e.fee.components.map(e=>({at:e.at,name:e.name,type:e.type,value:e.value,percentage:e.percentage,pair:e.pair,amount:e.amount}))},at:e.at,until:e.until,fromMediums:e.from_medium,toMediums:e.to_medium,rate:e.rate,ratio:e.ratio,fromLimits:e.from_limits,toLimits:e.to_limits,createdAt:e.created_at,updatedAt:e.updated_at}}}export{a as PseClient,s as SwapClient};

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

@@ -68,122 +68,89 @@ export interface PseBank {
 export interface ListPseBanksResponse {
     banks: PseBank[];
 }
-type Currency = 'DUSD/6' | 'COP/2' | 'KSM/12';
 /**
  * @internal
- * Payment item in request (snake_case)
+ * Order type for swap (source or destination amount specified)
  */
-export interface CreatePaymentItemInput {
-    name: string;
-    amount: string;
-    sku?: string;
-    description?: string;
-    quantity: number;
-    image_url?: string;
-}
+export type OrderType = 'src' | 'dst';
 /**
  * @internal
- * Create payment request body
+ * Deposit information for PSE top-up
  */
-export interface CreatePaymentInput {
-    name: string;
-    description?: string;
-    currency: Currency;
-    payment_type: string;
-    image_url?: string;
-    items: CreatePaymentItemInput[];
-    success_url?: string;
-    cancel_url?: string;
-    metadata?: Record<string, unknown>;
-    expires_at?: string;
-    webhook_url?: string;
+export interface DepositInformation {
+    urn: string;
 }
 /**
  * @internal
- * Payment item in response
+ * Create order input for PUT /api/order
  */
-export interface PaymentItemResponse {
-    name: string;
-    amount: number;
-    sku?: string;
-    description?: string;
-    quantity: number;
-    image_url?: string;
+export interface CreateOrderInput {
+    taker_urn: string;
+    type: OrderType;
+    rate_sig: string;
+    from_medium: string;
+    to_medium: string;
+    amount_src?: string;
+    amount_dst?: string;
+    deposit_information: DepositInformation;
+    args?: Record<string, unknown>;
+    node_id?: string;
+    metadata?: Record<string, unknown>;
 }
 /**
  * @internal
- * Payment summary from API
+ * Order from API response
  */
-export interface PaymentSummaryResponse {
+export interface OrderResponse {
+    id: string;
+    order_sig: string;
+    rate_sig: string;
+    swap_sig: string;
+    taker: string;
+    maker: string;
+    from_asset: string;
+    to_asset: string;
+    from_medium: string;
+    to_medium: string;
+    from_amount: string;
+    to_amount: string;
+    at: string;
+    graph_id: string;
     status: string;
-}
-/**
- * @internal
- * Payment response from API
- */
-export interface PaymentResponse {
-    urn: string;
-    owner_urn: string;
-    name: string;
-    description?: string;
-    currency: Currency;
-    amount: number;
-    url: string;
-    success_url?: string;
-    cancel_url?: string;
-    image_url?: string;
     metadata?: Record<string, unknown>;
-    tax?: number;
-    discount_code?: string;
-    webhook_url?: string;
-    payout_route: unknown[];
-    summary: PaymentSummaryResponse;
-    expires_at?: string;
     created_at: string;
     updated_at: string;
-    payment_type: string;
-    items: PaymentItemResponse[];
 }
 /**
  * @internal
- * Create payment API response wrapper
+ * Execution redirect instructions
  */
-export interface CreatePaymentResponse {
-    payment: PaymentResponse;
-}
-/**
- * @internal
- * Payee info for PSE payment
- */
-export interface PsePayeeInput {
-    name: string;
-    email: string;
-    id_type: string;
-    id_number: string;
+export interface ExecutionHow {
+    type: string;
+    url: string;
 }
 /**
  * @internal
- * Initiate PSE payment request body
+ * Execution result from auto-execution
  */
-export interface InitiatePsePaymentInput {
-    payment_urn: string;
-    payee: PsePayeeInput;
-    person_type: string;
-    bank_code: string;
+export interface ExecutionResult {
+    node_id: string;
+    result: {
+        status: string;
+        name?: string;
+        description?: string;
+        how?: ExecutionHow;
+        callback_token?: string;
+    };
 }
 /**
  * @internal
- * Initiate PSE payment response
+ * Create order response from PUT /api/order
  */
-export interface InitiatePsePaymentResponse {
-    payment_id: string;
-    status: string;
-    message: string;
-    amount: string;
-    currency: Currency;
-    checkout_url: string;
-    order_id: string;
-    order_status: string;
-    created_at: string;
+export interface CreateOrderResponse {
+    result: {
+        order: OrderResponse;
+        execution?: ExecutionResult;
+    };
+    req_id: string;
 }
-export {};

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

@@ -1,5 +1,5 @@
 import { BaseClient } from '@bloque/sdk-core';
-import type { CreateTopUpParams, CreateTopUpResult, InitiatePsePaymentParams, InitiatePsePaymentResult, ListBanksResult } from './types';
+import type { CreatePseOrderParams, CreatePseOrderResult, ListBanksResult } from './types';
 /**
  * PSE client for PSE-related utilities
  *
@@ -24,73 +24,70 @@ export declare class PseClient extends BaseClient {
      */
     banks(): Promise<ListBanksResult>;
     /**
-     * Create a PSE top-up
+     * Create a PSE swap order
      *
-     * Creates a payment intent for a PSE top-up/recharge.
-     * Use the returned payment URN with initiatePayment() to start the PSE flow.
+     * Creates a swap order using PSE as the source payment medium.
+     * Optionally auto-executes the first instruction node if args are provided.
      *
-     * @param params - Top-up creation parameters
-     * @returns Promise resolving to the created payment
+     * @param params - PSE order parameters
+     * @returns Promise resolving to the created order with optional execution result
      *
      * @example
      * ```typescript
-     * const result = await bloque.swap.pse.createTopUp({
-     *   amount: '50000000',
-     *   currency: 'DUSD/6',
-     *   successUrl: 'https://example.com/payment/success',
-     *   webhookUrl: 'https://myapp.com/webhooks/payment',
+     * // First find available rates
+     * const rates = await bloque.swap.findRates({
+     *   fromAsset: 'COP/2',
+     *   toAsset: 'DUSD/6',
+     *   fromMediums: ['pse'],
+     *   toMediums: ['kusama'],
+     *   amountSrc: '10000000'
      * });
      *
-     * // Use the URN to initiate PSE payment
-     * console.log(result.payment.urn);
-     * ```
-     */
-    createTopUp(params: CreateTopUpParams): Promise<CreateTopUpResult>;
-    /**
-     * Initiate a PSE payment
-     *
-     * Initiates the PSE payment flow for a previously created top-up.
-     * Returns a checkout URL where the user should be redirected to complete the payment.
-     *
-     * @param params - PSE payment parameters
-     * @returns Promise resolving to PSE payment result with checkout URL
-     *
-     * @example
-     * ```typescript
-     * // First create a top-up
-     * const topUp = await bloque.swap.pse.createTopUp({...});
-     *
-     * // Then initiate PSE payment with user details
-     * const result = await bloque.swap.pse.initiatePayment({
-     *   paymentUrn: topUp.payment.urn,
-     *   payee: {
-     *     name: 'Juan Pérez García',
-     *     email: 'juan.perez@example.com',
-     *     idType: 'CC',
-     *     idNumber: '1055228746',
+     * // Create order with auto-execution
+     * const result = await bloque.swap.pse.create({
+     *   rateSig: rates.rates[0].sig,
+     *   toMedium: 'kusama',
+     *   amountSrc: '10000000',
+     *   depositInformation: {
+     *     urn: 'did:bloque:account:card:usr-xxx:crd-xxx'
      *   },
-     *   personType: 'natural',
-     *   bankCode: '1',
+     *   args: {
+     *     bankCode: '1',
+     *     userType: 'natural',
+     *     customerEmail: 'user@example.com',
+     *     userLegalIdType: 'CC',
+     *     userLegalId: '1234567890',
+     *     customerData: {
+     *       fullName: 'John Doe'
+     *     }
+     *   }
      * });
      *
-     * // Redirect user to PSE
-     * window.location.href = result.checkoutUrl;
+     * // If execution returned a checkout URL, redirect user
+     * if (result.execution?.result.checkoutUrl) {
+     *   window.location.href = result.execution.result.checkoutUrl;
+     * }
      * ```
      */
-    initiatePayment(params: InitiatePsePaymentParams): Promise<InitiatePsePaymentResult>;
+    create(params: CreatePseOrderParams): Promise<CreatePseOrderResult>;
     /**
      * Maps API bank response to SDK format
      * @internal
      */
     private _mapBankResponse;
     /**
-     * Maps API payment response to SDK format
+     * Maps SDK deposit information to wire format
+     * @internal
+     */
+    private _mapDepositInformationToWire;
+    /**
+     * Maps API order response to SDK format
      * @internal
      */
-    private _mapPaymentResponse;
+    private _mapOrderResponse;
     /**
-     * Maps API payment item response to SDK format
+     * Maps API execution result to SDK format
      * @internal
      */
-    private _mapPaymentItemResponse;
+    private _mapExecutionResult;
 }

package/dist/pse/types.d.ts

@@ -1,4 +1,3 @@
-type Currency = 'DUSD/6' | 'COP/2' | 'KSM/12';
 export interface Bank {
     /**
      * Financial institution code
@@ -12,218 +11,240 @@ export interface Bank {
 export interface ListBanksResult {
     banks: Bank[];
 }
-export interface CreateTopUpParams {
-    /**
-     * Top-up amount as string (scaled by currency precision)
-     */
-    amount: string;
-    /**
-     * Currency with precision (e.g., "DUSD/6")
-     */
-    currency: Currency;
-    /**
-     * URL to redirect on successful payment
-     */
-    successUrl?: string;
-    /**
-     * Webhook URL for payment notifications
+/**
+ * Order type for swap
+ * - 'src': Taker specifies exact source amount to pay
+ * - 'dst': Taker specifies exact destination amount to receive
+ */
+export type OrderType = 'src' | 'dst';
+/**
+ * Deposit information for PSE top-up
+ */
+export interface DepositInformation {
+    /**
+     * Account URN where funds will be deposited
+     * @example "did:bloque:account:card:usr-xxx:crd-xxx"
      */
-    webhookUrl?: string;
+    urn: string;
 }
-export interface PaymentItemResult {
+/**
+ * Customer data for PSE payment
+ */
+export interface PseCustomerData {
     /**
-     * Item name
+     * Customer's full name
      */
-    name: string;
+    fullName: string;
+}
+/**
+ * PSE payment arguments for auto-execution
+ */
+export interface PsePaymentArgs {
     /**
-     * Item amount (as number)
+     * Bank code from PSE banks list
      */
-    amount: number;
+    bankCode: string;
     /**
-     * Stock keeping unit identifier
+     * User type: 'natural' for natural person, 'juridica' for legal entity
      */
-    sku?: string;
+    userType?: 'natural' | 'juridica';
     /**
-     * Item description
+     * Customer email address
      */
-    description?: string;
+    customerEmail?: string;
     /**
-     * Item quantity
+     * User legal ID type (e.g., 'CC', 'NIT', 'CE')
      */
-    quantity: number;
+    userLegalIdType?: 'CC' | 'NIT' | 'CE';
     /**
-     * URL to item image
+     * User legal ID number
      */
-    imageUrl?: string;
-}
-export interface PaymentSummary {
+    userLegalId?: string;
     /**
-     * Payment status
+     * Additional customer data
      */
-    status: string;
+    customerData?: PseCustomerData;
 }
-export interface Payment {
+/**
+ * Parameters for creating a PSE swap order
+ */
+export interface CreatePseOrderParams {
     /**
-     * Payment URN identifier
+     * Rate signature from findRates
      */
-    urn: string;
+    rateSig: string;
     /**
-     * Owner URN
+     * Destination medium (e.g., 'kreivo', 'bloque')
      */
-    ownerUrn: string;
+    toMedium: string;
     /**
-     * Payment name/title
+     * Source amount as bigint string (required if type is 'src')
+     * @example "1000000" represents 10000.00 for COP/2
      */
-    name: string;
+    amountSrc?: string;
     /**
-     * Payment description
+     * Destination amount as bigint string (required if type is 'dst')
      */
-    description?: string;
+    amountDst?: string;
     /**
-     * Currency with precision
+     * Order type (default: 'src')
      */
-    currency: Currency;
+    type?: OrderType;
     /**
-     * Total amount
+     * Deposit information with the account URN where funds will be deposited
      */
-    amount: number;
+    depositInformation: DepositInformation;
     /**
-     * Hosted payment URL
+     * PSE payment arguments for auto-execution
      */
-    url: string;
+    args?: PsePaymentArgs;
     /**
-     * Success redirect URL
+     * Specific node ID to execute (defaults to first node)
      */
-    successUrl?: string;
+    nodeId?: string;
     /**
-     * Cancel redirect URL
-     */
-    cancelUrl?: string;
-    /**
-     * Payment image URL
-     */
-    imageUrl?: string;
-    /**
-     * Additional metadata
+     * Additional metadata for the order
      */
     metadata?: Record<string, unknown>;
+}
+/**
+ * Swap order details
+ */
+export interface SwapOrder {
     /**
-     * Tax amount
+     * Unique order identifier
      */
-    tax?: number;
+    id: string;
     /**
-     * Applied discount code
+     * Order signature
      */
-    discountCode?: string;
+    orderSig: string;
     /**
-     * Webhook URL
+     * Rate signature used for this order
      */
-    webhookUrl?: string;
+    rateSig: string;
     /**
-     * Payout route configuration
+     * Swap signature
      */
-    payoutRoute: unknown[];
+    swapSig: string;
     /**
-     * Payment summary
+     * Taker URN
      */
-    summary: PaymentSummary;
+    taker: string;
     /**
-     * Expiration date
+     * Maker URN
      */
-    expiresAt?: string;
+    maker: string;
     /**
-     * Creation timestamp
+     * Source asset
      */
-    createdAt: string;
+    fromAsset: string;
     /**
-     * Last update timestamp
+     * Destination asset
      */
-    updatedAt: string;
+    toAsset: string;
     /**
-     * Payment type
+     * Source medium
      */
-    paymentType: string;
+    fromMedium: string;
     /**
-     * Payment items
+     * Destination medium
      */
-    items: PaymentItemResult[];
-}
-export interface CreateTopUpResult {
-    payment: Payment;
-}
-export interface PsePayee {
+    toMedium: string;
     /**
-     * Full name of the payee
+     * Source amount
      */
-    name: string;
+    fromAmount: string;
     /**
-     * Email address
+     * Destination amount
      */
-    email: string;
+    toAmount: string;
     /**
-     * ID document type (e.g., "CC" for Cédula de Ciudadanía)
+     * Timestamp when the order was created (as string)
      */
-    idType: string;
+    at: string;
     /**
-     * ID document number
+     * Instruction graph ID for tracking execution
      */
-    idNumber: string;
-}
-export type PersonType = 'natural' | 'juridica';
-export interface InitiatePsePaymentParams {
+    graphId: string;
     /**
-     * Payment URN from createTopUp
+     * Order status (pending, in_progress, completed, failed)
      */
-    paymentUrn: string;
+    status: string;
     /**
-     * Payee information
+     * Additional metadata
      */
-    payee: PsePayee;
+    metadata?: Record<string, unknown>;
     /**
-     * Person type (natural or juridica)
+     * Creation timestamp
      */
-    personType: PersonType;
+    createdAt: string;
     /**
-     * Bank code from banks list
+     * Last update timestamp
      */
-    bankCode: string;
+    updatedAt: string;
 }
-export interface InitiatePsePaymentResult {
-    /**
-     * Payment ID
-     */
-    paymentId: string;
-    /**
-     * Payment status
-     */
-    status: string;
+/**
+ * Redirect instructions for completing the payment
+ */
+export interface ExecutionHow {
     /**
-     * Status message
+     * Type of action required (e.g., "REDIRECT")
      */
-    message: string;
+    type: string;
     /**
-     * Payment amount
+     * URL to redirect the user to complete the payment
      */
-    amount: string;
-    /**
-     * Currency
-     */
-    currency: Currency;
-    /**
-     * PSE checkout URL to redirect the user
-     */
-    checkoutUrl: string;
+    url: string;
+}
+/**
+ * Execution result from auto-execution
+ */
+export interface ExecutionResult {
+    /**
+     * Node ID that was executed
+     */
+    nodeId: string;
+    /**
+     * Execution result details
+     */
+    result: {
+        /**
+         * Execution status (e.g., "paused")
+         */
+        status: string;
+        /**
+         * Name of the current step
+         */
+        name?: string;
+        /**
+         * Description of what the user needs to do
+         */
+        description?: string;
+        /**
+         * Instructions for completing this step
+         */
+        how?: ExecutionHow;
+        /**
+         * Callback token for tracking
+         */
+        callbackToken?: string;
+    };
+}
+/**
+ * Result of creating a PSE swap order
+ */
+export interface CreatePseOrderResult {
     /**
-     * Order ID
+     * The created order
      */
-    orderId: string;
+    order: SwapOrder;
     /**
-     * Order status
+     * Execution result (if args were provided for auto-execution)
      */
-    orderStatus: string;
+    execution?: ExecutionResult;
     /**
-     * Creation timestamp
+     * Request ID for tracking
      */
-    createdAt: string;
+    requestId: string;
 }
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloque/sdk-swap",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "type": "module",
   "keywords": [
     "bloque",
@@ -34,6 +34,6 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@bloque/sdk-core": "0.0.30"
+    "@bloque/sdk-core": "0.0.32"
   }
 }