@bloque/sdk-accounts 0.0.4 → 0.0.10

package/README.md

@@ -5,6 +5,7 @@ Financial accounts and payment methods client for the [Bloque](https://www.bloqu
 ## Features
 
 - **Virtual Cards**: Create virtual cards instantly
+- **Bancolombia Accounts**: Create Bancolombia accounts with reference codes
 - **TypeScript First**: Built with TypeScript for complete type safety
 - **Simple API**: Minimal input required - just URN and optional name
 - **Fully Async**: Promise-based API for modern JavaScript workflows
@@ -46,6 +47,17 @@ console.log('Card created:', card.urn);
 console.log('Last four digits:', card.lastFour);
 console.log('Card details URL:', card.detailsUrl);
 console.log('Status:', card.status);
+
+// Create a Bancolombia account
+const bancolombiaAccount = await bloque.accounts.bancolombia.create({
+  urn: 'did:bloque:user:123',
+  name: 'Main Account', // Optional
+  cardUrn: card.urn, // Optional - link with existing card
+});
+
+console.log('Bancolombia account created:', bancolombiaAccount.urn);
+console.log('Reference code:', bancolombiaAccount.referenceCode);
+console.log('Status:', bancolombiaAccount.status);
 ```
 
 ## API Reference
@@ -99,6 +111,64 @@ interface CardAccount {
 }
 ```
 
+### Bancolombia Accounts
+
+Create Bancolombia accounts with reference codes for local payments.
+
+#### `bancolombia.create(params)`
+
+```typescript
+const account = await bloque.accounts.bancolombia.create({
+  urn: 'did:bloque:user:123',
+  name: 'Main Account', // Optional
+  cardUrn: 'did:bloque:card:456', // Optional - link with existing card
+});
+```
+
+**Parameters**:
+
+```typescript
+interface CreateBancolombiaAccountParams {
+  /**
+   * URN of the account holder (user or organization)
+   * @example "did:bloque:user:123e4567"
+   */
+  urn: string;
+
+  /**
+   * Display name for the account (optional)
+   */
+  name?: string;
+
+  /**
+   * URN of an existing card to link with the Bancolombia account (optional)
+   * @example "did:bloque:card:123e4567"
+   */
+  cardUrn?: string;
+
+  /**
+   * Custom metadata to attach to the Bancolombia account (optional)
+   */
+  metadata?: Record<string, unknown>;
+}
+```
+
+**Returns**:
+
+```typescript
+interface BancolombiaAccount {
+  urn: string;                    // Unique resource name
+  id: string;                     // Account ID
+  referenceCode: string;          // Reference code for payments
+  status: 'active' | 'disabled' | 'frozen' | 'deleted' | 'creation_in_progress' | 'creation_failed';
+  ownerUrn: string;               // Owner URN
+  webhookUrl: string | null;      // Webhook URL (if configured)
+  metadata?: Record<string, unknown>; // Custom metadata
+  createdAt: string;              // Creation timestamp (ISO 8601)
+  updatedAt: string;              // Last update timestamp (ISO 8601)
+}
+```
+
 ## Complete Examples
 
 ### Basic Card Creation
@@ -199,6 +269,81 @@ try {
 }
 ```
 
+### Basic Bancolombia Account Creation
+
+```typescript
+import { SDK } from '@bloque/sdk';
+
+const bloque = new SDK({
+  apiKey: process.env.BLOQUE_API_KEY!,
+  mode: 'production',
+});
+
+// Create a Bancolombia account with just URN
+const account = await bloque.accounts.bancolombia.create({
+  urn: 'did:bloque:user:123e4567',
+});
+
+console.log('Account created:', account.urn);
+console.log('Reference code:', account.referenceCode);
+console.log('Status:', account.status);
+```
+
+### Bancolombia Account with Card Link
+
+```typescript
+import { SDK } from '@bloque/sdk';
+
+const bloque = new SDK({
+  apiKey: process.env.BLOQUE_API_KEY!,
+  mode: 'production',
+});
+
+const userUrn = 'did:bloque:user:123e4567';
+
+// Create a card first
+const card = await bloque.accounts.card.create({
+  urn: userUrn,
+  name: 'My Card',
+});
+
+// Create Bancolombia account and link it to the card
+const account = await bloque.accounts.bancolombia.create({
+  urn: userUrn,
+  name: 'Main Account',
+  cardUrn: card.urn, // Link to existing card
+});
+
+console.log('Card URN:', card.urn);
+console.log('Account URN:', account.urn);
+console.log('Reference code for payments:', account.referenceCode);
+```
+
+### Bancolombia Account with Metadata
+
+```typescript
+import { SDK } from '@bloque/sdk';
+
+const bloque = new SDK({
+  apiKey: process.env.BLOQUE_API_KEY!,
+  mode: 'production',
+});
+
+// Create Bancolombia account with custom metadata
+const account = await bloque.accounts.bancolombia.create({
+  urn: 'did:bloque:user:123e4567',
+  name: 'Business Account',
+  metadata: {
+    purpose: 'business-payments',
+    department: 'sales',
+    customField: 'custom-value',
+  },
+});
+
+console.log('Account created with metadata:', account.metadata);
+console.log('Reference code:', account.referenceCode);
+```
+
 ## TypeScript Support
 
 This package is written in TypeScript and includes complete type definitions:
@@ -207,32 +352,47 @@ This package is written in TypeScript and includes complete type definitions:
 import type {
   CardAccount,
   CreateCardParams,
+  BancolombiaAccount,
+  CreateBancolombiaAccountParams,
 } from '@bloque/sdk-accounts';
 
 // Type-safe card creation
-const params: CreateCardParams = {
+const cardParams: CreateCardParams = {
   urn: 'did:bloque:user:123e4567',
   name: 'My Card', // Optional
 };
 
-const card: CardAccount = await bloque.accounts.card.create(params);
+const card: CardAccount = await bloque.accounts.card.create(cardParams);
 
 // TypeScript infers all card properties with full type safety
 console.log(card.lastFour); // string
 console.log(card.status);   // 'active' | 'disabled' | 'frozen' | 'deleted' | 'creation_in_progress' | 'creation_failed'
 console.log(card.cardType); // 'VIRTUAL' | 'PHYSICAL'
+
+// Type-safe Bancolombia account creation
+const accountParams: CreateBancolombiaAccountParams = {
+  urn: 'did:bloque:user:123e4567',
+  name: 'Main Account', // Optional
+  cardUrn: card.urn, // Optional
+};
+
+const account: BancolombiaAccount = await bloque.accounts.bancolombia.create(accountParams);
+
+// TypeScript infers all account properties with full type safety
+console.log(account.referenceCode); // string
+console.log(account.status);        // 'active' | 'disabled' | 'frozen' | 'deleted' | 'creation_in_progress' | 'creation_failed'
 ```
 
-## Card Status
+## Account Status
 
-Cards have a status field indicating their current state:
+Both cards and Bancolombia accounts have a status field indicating their current state:
 
-- `creation_in_progress`: Card is being created
-- `creation_failed`: Card creation failed
-- `active`: Card is active and ready to use
-- `disabled`: Card has been disabled
-- `frozen`: Card has been temporarily frozen
-- `deleted`: Card has been deleted
+- `creation_in_progress`: Account/card is being created
+- `creation_failed`: Account/card creation failed
+- `active`: Account/card is active and ready to use
+- `disabled`: Account/card has been disabled
+- `frozen`: Account/card has been temporarily frozen
+- `deleted`: Account/card has been deleted
 
 ## Requirements
 

package/dist/index.cjs

@@ -25,9 +25,10 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     AccountsClient: ()=>AccountsClient,
-    CardClient: ()=>CardClient
+    CardClient: ()=>CardClient,
+    BancolombiaClient: ()=>BancolombiaClient
 });
-class CardClient {
+class BancolombiaClient {
     httpClient;
     constructor(httpClient){
         this.httpClient = httpClient;
@@ -35,31 +36,25 @@ class CardClient {
     async create(params) {
         const request = {
             holder_urn: params.urn,
-            input: {
-                create: {
-                    card_type: 'VIRTUAL'
-                }
-            },
+            input: {},
             metadata: {
                 source: "sdk-typescript",
                 name: params.name,
+                card_urn: params.cardUrn,
                 ...params.metadata
             }
         };
         const response = await this.httpClient.request({
             method: 'POST',
-            path: '/api/mediums/card',
+            path: '/api/mediums/bancolombia',
             body: request
         });
         const account = response.result.account;
         return {
             urn: account.urn,
             id: account.id,
-            lastFour: account.details.card_last_four,
-            productType: account.details.card_product_type,
+            referenceCode: account.details.reference_code,
             status: account.status,
-            cardType: account.details.card_type,
-            detailsUrl: account.details.card_url_details,
             ownerUrn: account.owner_urn,
             webhookUrl: account.webhook_url,
             metadata: account.metadata,
@@ -68,7 +63,7 @@ class CardClient {
         };
     }
 }
-class BancolombiaClient {
+class CardClient {
     httpClient;
     constructor(httpClient){
         this.httpClient = httpClient;
@@ -76,25 +71,31 @@ class BancolombiaClient {
     async create(params) {
         const request = {
             holder_urn: params.urn,
-            input: {},
+            input: {
+                create: {
+                    card_type: 'VIRTUAL'
+                }
+            },
             metadata: {
                 source: "sdk-typescript",
                 name: params.name,
-                card_urn: params.cardUrn,
                 ...params.metadata
             }
         };
         const response = await this.httpClient.request({
             method: 'POST',
-            path: '/api/mediums/bancolombia',
+            path: '/api/mediums/card',
             body: request
         });
         const account = response.result.account;
         return {
             urn: account.urn,
             id: account.id,
-            referenceCode: account.details.reference_code,
+            lastFour: account.details.card_last_four,
+            productType: account.details.card_product_type,
             status: account.status,
+            cardType: account.details.card_type,
+            detailsUrl: account.details.card_url_details,
             ownerUrn: account.owner_urn,
             webhookUrl: account.webhook_url,
             metadata: account.metadata,
@@ -114,9 +115,11 @@ class AccountsClient {
     }
 }
 exports.AccountsClient = __webpack_exports__.AccountsClient;
+exports.BancolombiaClient = __webpack_exports__.BancolombiaClient;
 exports.CardClient = __webpack_exports__.CardClient;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "AccountsClient",
+    "BancolombiaClient",
     "CardClient"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export * from './bancolombia/client';
+export * from './bancolombia/types';
 export * from './card/client';
 export * from './card/types';
 export * from './client';

package/dist/index.js

@@ -1,4 +1,4 @@
-class CardClient {
+class BancolombiaClient {
     httpClient;
     constructor(httpClient){
         this.httpClient = httpClient;
@@ -6,31 +6,25 @@ class CardClient {
     async create(params) {
         const request = {
             holder_urn: params.urn,
-            input: {
-                create: {
-                    card_type: 'VIRTUAL'
-                }
-            },
+            input: {},
             metadata: {
                 source: "sdk-typescript",
                 name: params.name,
+                card_urn: params.cardUrn,
                 ...params.metadata
             }
         };
         const response = await this.httpClient.request({
             method: 'POST',
-            path: '/api/mediums/card',
+            path: '/api/mediums/bancolombia',
             body: request
         });
         const account = response.result.account;
         return {
             urn: account.urn,
             id: account.id,
-            lastFour: account.details.card_last_four,
-            productType: account.details.card_product_type,
+            referenceCode: account.details.reference_code,
             status: account.status,
-            cardType: account.details.card_type,
-            detailsUrl: account.details.card_url_details,
             ownerUrn: account.owner_urn,
             webhookUrl: account.webhook_url,
             metadata: account.metadata,
@@ -39,7 +33,7 @@ class CardClient {
         };
     }
 }
-class BancolombiaClient {
+class CardClient {
     httpClient;
     constructor(httpClient){
         this.httpClient = httpClient;
@@ -47,25 +41,31 @@ class BancolombiaClient {
     async create(params) {
         const request = {
             holder_urn: params.urn,
-            input: {},
+            input: {
+                create: {
+                    card_type: 'VIRTUAL'
+                }
+            },
             metadata: {
                 source: "sdk-typescript",
                 name: params.name,
-                card_urn: params.cardUrn,
                 ...params.metadata
             }
         };
         const response = await this.httpClient.request({
             method: 'POST',
-            path: '/api/mediums/bancolombia',
+            path: '/api/mediums/card',
             body: request
         });
         const account = response.result.account;
         return {
             urn: account.urn,
             id: account.id,
-            referenceCode: account.details.reference_code,
+            lastFour: account.details.card_last_four,
+            productType: account.details.card_product_type,
             status: account.status,
+            cardType: account.details.card_type,
+            detailsUrl: account.details.card_url_details,
             ownerUrn: account.owner_urn,
             webhookUrl: account.webhook_url,
             metadata: account.metadata,
@@ -84,4 +84,4 @@ class AccountsClient {
         this.card = new CardClient(this.httpClient);
     }
 }
-export { AccountsClient, CardClient };
+export { AccountsClient, BancolombiaClient, CardClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloque/sdk-accounts",
-  "version": "0.0.4",
+  "version": "0.0.10",
   "type": "module",
   "keywords": [
     "bloque",
@@ -36,6 +36,7 @@
     "node": ">=22"
   },
   "scripts": {
+    "release": "bun publish",
     "build": "rslib build",
     "dev": "rslib build --watch",
     "clean": "rm -rf node_modules && rm -rf dist",
@@ -43,12 +44,12 @@
     "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@bloque/sdk-core": "workspace:*"
+    "@bloque/sdk-core": "0.0.2"
   },
   "devDependencies": {
-    "@rslib/core": "catalog:",
-    "@types/node": "catalog:",
-    "@typescript/native-preview": "catalog:",
-    "typescript": "catalog:"
+    "@rslib/core": "^0.18.4",
+    "@types/node": "^24.10.1",
+    "@typescript/native-preview": "latest",
+    "typescript": "^5.9.3"
   }
 }