@bloque/sdk-identity 0.0.19 → 0.0.21

package/README.md

@@ -4,10 +4,13 @@ Identity, aliases, and OTP authentication API client for the Bloque SDK.
 
 ## Features
 
+- **Identity Registration**: Register individual users (KYC) and businesses (KYB) to authentication origins
+- **Multi-Origin Support**: Register identities across blockchain, OAuth, API key, and custom origins
 - **Origin Management**: List and discover all available authentication origins
 - **Aliases**: Get user identity information by email or phone
 - **OTP Origins**: Send OTP codes via WhatsApp or Email
 - **Custom Origins**: Support for custom authentication origins
+- **Multiple Authentication Methods**: SIGNING_CHALLENGE, API_KEY, OAUTH_REDIRECT, WEBAUTHN, OTP, PASSWORD
 - **TypeScript First**: Built with TypeScript for complete type safety
 
 ## Installation
@@ -179,6 +182,133 @@ interface Origin {
 
 **Returns**: `Promise<Origin[]>` - Array of all registered origins
 
+#### `origins.register(origin, params)`
+
+Register a new user or business identity to a specific origin. Supports both individual users (KYC) and businesses (KYB) with various authentication methods:
+
+```typescript
+// Register individual with blockchain signature
+const individual = await identity.origins.register('ethereum-mainnet', {
+  assertionResult: {
+    alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
+    challengeType: 'SIGNING_CHALLENGE',
+    value: {
+      signature: '0x1234...',
+      alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6'
+    }
+  },
+  type: 'individual',
+  profile: {
+    firstName: 'John',
+    lastName: 'Doe',
+    email: 'john@example.com'
+  }
+});
+
+// Register business with API key
+const business = await identity.origins.register('bloque-api', {
+  assertionResult: {
+    alias: 'business-123',
+    challengeType: 'API_KEY',
+    value: {
+      apiKey: 'sk_live_abc123',
+      alias: 'business-123'
+    }
+  },
+  type: 'business',
+  profile: {
+    legalName: 'Acme Corporation',
+    name: 'Acme Corp',
+    taxId: '12-3456789',
+    type: 'LLC',
+    incorporationDate: '2020-01-15',
+    addressLine1: '123 Business St',
+    city: 'New York',
+    state: 'NY',
+    postalCode: '10001',
+    country: 'United States'
+  }
+});
+```
+
+**Parameters**:
+- `origin` (string): Origin namespace to register to (e.g., 'ethereum-mainnet', 'bloque-api')
+- `params` (RegisterParams): Registration parameters
+
+**Assertion Challenge Types**:
+- `SIGNING_CHALLENGE`: Blockchain signature verification
+- `API_KEY`: Traditional API key authentication
+- `OAUTH_REDIRECT`: OAuth-based flows
+- `WEBAUTHN`: WebAuthn/passkey authentication
+- `OTP`: One-time password verification
+- `PASSWORD`: Password-based authentication
+
+**Individual Profile (KYC)**:
+```typescript
+interface UserProfile {
+  firstName?: string;
+  lastName?: string;
+  birthdate?: string;           // ISO 8601 (YYYY-MM-DD)
+  email?: string;
+  phone?: string;
+  gender?: string;
+  addressLine1?: string;
+  addressLine2?: string;
+  city?: string;
+  state?: string;
+  postalCode?: string;
+  neighborhood?: string;
+  countryOfBirthCode?: string;
+  countryOfResidenceCode?: string;
+  personalIdType?: string;
+  personalIdNumber?: string;
+}
+```
+
+**Business Profile (KYB)**:
+```typescript
+interface BusinessProfile {
+  // Required fields
+  addressLine1: string;
+  city: string;
+  country: string;
+  incorporationDate: string;    // YYYY-MM-DD
+  legalName: string;
+  name: string;
+  postalCode: string;
+  state: string;
+  taxId: string;
+  type: string;                 // LLC, Corporation, etc.
+
+  // Optional fields
+  addressLine2?: string;
+  countryCode?: string;
+  email?: string;
+  logo?: string;
+  phone?: string;
+
+  // Owner information
+  ownerName?: string;
+  ownerIdType?: string;
+  ownerIdNumber?: string;
+  ownerAddressLine1?: string;
+  ownerAddressLine2?: string;
+  ownerCity?: string;
+  ownerState?: string;
+  ownerPostalCode?: string;
+  ownerCountryCode?: string;
+}
+```
+
+**Response**:
+```typescript
+interface RegisterResult {
+  accessToken: string;  // JWT token for authenticated sessions
+}
+```
+
+**Returns**: `Promise<RegisterResult>` - Registration result with access token
+
 ## Examples
 
 ### Get Email Alias
@@ -214,7 +344,10 @@ try {
 import { SDK } from '@bloque/sdk';
 
 const bloque = new SDK({
-  apiKey: process.env.BLOQUE_API_KEY!,
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
   mode: 'production',
 });
 
@@ -237,7 +370,10 @@ try {
 import { SDK } from '@bloque/sdk';
 
 const bloque = new SDK({
-  apiKey: process.env.BLOQUE_API_KEY!,
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
   mode: 'production',
 });
 
@@ -260,7 +396,10 @@ try {
 import { SDK } from '@bloque/sdk';
 
 const bloque = new SDK({
-  apiKey: process.env.BLOQUE_API_KEY!,
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
   mode: 'production',
 });
 
@@ -304,7 +443,10 @@ await authenticateUser('user@example.com');
 import { SDK } from '@bloque/sdk';
 
 const bloque = new SDK({
-  apiKey: process.env.BLOQUE_API_KEY!,
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
   mode: 'production',
 });
 
@@ -338,7 +480,10 @@ try {
 import { SDK } from '@bloque/sdk';
 
 const bloque = new SDK({
-  apiKey: process.env.BLOQUE_API_KEY!,
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
   mode: 'production',
 });
 
@@ -361,7 +506,10 @@ try {
 import { SDK } from '@bloque/sdk';
 
 const bloque = new SDK({
-  apiKey: process.env.BLOQUE_API_KEY!,
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
   mode: 'production',
 });
 
@@ -395,6 +543,213 @@ async function sendOTPWithRetry(phone: string, maxRetries = 3) {
 await sendOTPWithRetry('+1234567890');
 ```
 
+### Register Individual User (KYC)
+
+```typescript
+import { SDK } from '@bloque/sdk';
+
+const bloque = new SDK({
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
+  mode: 'production',
+});
+
+try {
+  // Register individual with blockchain signature
+  const result = await bloque.identity.origins.register('ethereum-mainnet', {
+    assertionResult: {
+      alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
+      challengeType: 'SIGNING_CHALLENGE',
+      value: {
+        signature: '0x1234567890abcdef...',
+        alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6'
+      },
+      originalChallengeParams: {
+        challenge: 'bloque-challenge-1234567890',
+        timestamp: 1640995200
+      }
+    },
+    type: 'individual',
+    profile: {
+      firstName: 'John',
+      lastName: 'Doe',
+      email: 'john.doe@example.com',
+      phone: '+1234567890',
+      birthdate: '1990-01-15',
+      city: 'New York',
+      state: 'NY',
+      postalCode: '10001',
+      addressLine1: '123 Main St',
+      countryOfBirthCode: 'USA',
+      countryOfResidenceCode: 'USA',
+      personalIdType: 'SSN',
+      personalIdNumber: '123-45-6789'
+    }
+  });
+
+  console.log('User registered successfully!');
+  console.log('Access token:', result.accessToken);
+
+  // Use the access token for authenticated API calls
+  // Store it securely for the user's session
+} catch (error) {
+  console.error('Registration failed:', error);
+}
+```
+
+### Register Business (KYB)
+
+```typescript
+import { SDK } from '@bloque/sdk';
+
+const bloque = new SDK({
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
+  mode: 'production',
+});
+
+try {
+  // Register business with API key authentication
+  const result = await bloque.identity.origins.register('bloque-api', {
+    assertionResult: {
+      alias: 'business-123',
+      challengeType: 'API_KEY',
+      value: {
+        apiKey: 'sk_live_abc123def456',
+        alias: 'business-123'
+      }
+    },
+    type: 'business',
+    profile: {
+      // Required business information
+      legalName: 'Acme Corporation',
+      name: 'Acme Corp',
+      taxId: '12-3456789',
+      type: 'LLC',
+      incorporationDate: '2020-01-15',
+      addressLine1: '123 Business St',
+      city: 'New York',
+      state: 'NY',
+      postalCode: '10001',
+      country: 'United States',
+
+      // Optional business information
+      addressLine2: 'Suite 100',
+      countryCode: 'US',
+      email: 'contact@acme.com',
+      phone: '+1-555-0123',
+      logo: 'https://acme.com/logo.png',
+
+      // Beneficial owner information
+      ownerName: 'Jane Smith',
+      ownerIdType: 'SSN',
+      ownerIdNumber: '123-45-6789',
+      ownerAddressLine1: '456 Owner Ave',
+      ownerCity: 'New York',
+      ownerState: 'NY',
+      ownerPostalCode: '10002',
+      ownerCountryCode: 'US'
+    }
+  });
+
+  console.log('Business registered successfully!');
+  console.log('Access token:', result.accessToken);
+
+  // Use the access token for authenticated API calls
+} catch (error) {
+  console.error('Business registration failed:', error);
+}
+```
+
+### Multi-Origin Registration Flow
+
+```typescript
+import { SDK } from '@bloque/sdk';
+
+const bloque = new SDK({
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
+  mode: 'production',
+});
+
+async function registerUserAcrossOrigins(userProfile: any) {
+  try {
+    // Step 1: List available origins
+    const origins = await bloque.identity.origins.list();
+    const activeOrigins = origins.filter(o => o.status === 'active');
+
+    console.log(`Found ${activeOrigins.length} active origins`);
+
+    // Step 2: Register on blockchain origin
+    const ethereumOrigin = activeOrigins.find(o => o.namespace === 'ethereum-mainnet');
+
+    if (ethereumOrigin) {
+      const ethereumResult = await bloque.identity.origins.register('ethereum-mainnet', {
+        assertionResult: {
+          alias: userProfile.walletAddress,
+          challengeType: 'SIGNING_CHALLENGE',
+          value: {
+            signature: userProfile.signature,
+            alias: userProfile.walletAddress
+          }
+        },
+        type: 'individual',
+        profile: userProfile.personalInfo
+      });
+
+      console.log('Registered on Ethereum:', ethereumResult.accessToken);
+    }
+
+    // Step 3: Register on custom origin
+    const customResult = await bloque.identity.origins.register('bloque-custom', {
+      assertionResult: {
+        alias: userProfile.customId,
+        challengeType: 'API_KEY',
+        value: {
+          apiKey: userProfile.apiKey,
+          alias: userProfile.customId
+        }
+      },
+      type: 'individual',
+      profile: userProfile.personalInfo
+    });
+
+    console.log('Registered on custom origin:', customResult.accessToken);
+
+    return {
+      ethereum: ethereumOrigin ? true : false,
+      custom: true,
+      tokens: {
+        ethereum: ethereumOrigin ? 'stored' : null,
+        custom: 'stored'
+      }
+    };
+  } catch (error) {
+    console.error('Multi-origin registration failed:', error);
+    throw error;
+  }
+}
+
+// Usage
+await registerUserAcrossOrigins({
+  walletAddress: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
+  signature: '0xabcdef...',
+  customId: 'user-123',
+  apiKey: 'sk_live_abc123',
+  personalInfo: {
+    firstName: 'Alice',
+    lastName: 'Johnson',
+    email: 'alice@example.com'
+  }
+});
+```
+
 ## TypeScript Support
 
 This package is written in TypeScript and includes complete type definitions:
@@ -410,6 +765,13 @@ import type {
   AliasesClient,
   OriginsClient,
   OriginClient,
+  // Registration types
+  RegisterParams,
+  IndividualRegisterParams,
+  BusinessRegisterParams,
+  RegisterResult,
+  UserProfile,
+  BusinessProfile,
 } from '@bloque/sdk-identity';
 
 // Type-safe alias retrieval
@@ -433,6 +795,55 @@ const otp: OTPAssertion =
 // Custom origin client
 const customOrigin: OriginClient<OTPAssertion> =
   identity.origins.custom('my-origin');
+
+// Type-safe individual registration
+const individualParams: IndividualRegisterParams = {
+  assertionResult: {
+    alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
+    challengeType: 'SIGNING_CHALLENGE',
+    value: {
+      signature: '0x123...',
+      alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6'
+    }
+  },
+  type: 'individual',
+  profile: {
+    firstName: 'John',
+    lastName: 'Doe',
+    email: 'john@example.com'
+  }
+};
+
+const individualResult: RegisterResult =
+  await identity.origins.register('ethereum-mainnet', individualParams);
+
+// Type-safe business registration
+const businessParams: BusinessRegisterParams = {
+  assertionResult: {
+    alias: 'business-123',
+    challengeType: 'API_KEY',
+    value: {
+      apiKey: 'sk_live_abc123',
+      alias: 'business-123'
+    }
+  },
+  type: 'business',
+  profile: {
+    legalName: 'Acme Corp',
+    name: 'Acme',
+    taxId: '12-3456789',
+    type: 'LLC',
+    incorporationDate: '2020-01-15',
+    addressLine1: '123 Business St',
+    city: 'New York',
+    state: 'NY',
+    postalCode: '10001',
+    country: 'United States'
+  }
+};
+
+const businessResult: RegisterResult =
+  await identity.origins.register('bloque-api', businessParams);
 ```
 
 ## Use with Main SDK
@@ -443,7 +854,10 @@ When using through the main `@bloque/sdk` package:
 import { SDK } from '@bloque/sdk';
 
 const bloque = new SDK({
-  apiKey: process.env.BLOQUE_API_KEY!,
+  auth: {
+    type: 'apiKey',
+    apiKey: process.env.BLOQUE_API_KEY!,
+  },
   mode: 'production',
 });
 
@@ -454,11 +868,20 @@ const otp = await bloque.identity.origins.whatsapp.assert('+1234567890');
 
 ## Key Features
 
+### Identity Registration
+
+- **Individual Registration (KYC)**: Register users with Know Your Customer compliance
+- **Business Registration (KYB)**: Register businesses with Know Your Business compliance
+- **Multi-Method Authentication**: Support for blockchain signatures, API keys, OAuth, WebAuthn, OTP, and passwords
+- **Cross-Origin Support**: Register identities across multiple authentication origins
+- **Secure Token Generation**: Receive JWT access tokens for authenticated sessions
+
 ### Origin Management
 
 - **List Origins**: Retrieve all available authentication origins
 - **Filter by Provider**: Find origins by provider type (evm, auth0, whatsapp, etc.)
 - **Check Status**: Monitor origin availability and status
+- **Custom Registration**: Register to custom authentication providers
 
 ### OTP Authentication Channels
 
@@ -480,6 +903,12 @@ OTP assertions include built-in rate limiting:
 - Support for primary and public aliases
 - Rich metadata support
 
+### Compliance Support
+
+- **KYC (Know Your Customer)**: Complete individual profile fields including identity verification
+- **KYB (Know Your Business)**: Business entity information with beneficial owner details
+- **Data Privacy**: Secure handling of sensitive personal and business information
+
 ## Requirements
 
 - Node.js 22.x or higher / Bun 1.x or higher

package/dist/api-types.d.ts

@@ -63,4 +63,162 @@ export interface Origin {
      */
     updated_at: string;
 }
+type SigningChallengeValue = {
+    signature: string;
+    alias: string;
+};
+type ApiKeyValue = {
+    api_key: string;
+    alias: string;
+};
+type BaseAssertion<TType extends string, TValue> = {
+    alias: string;
+    challengeType: TType;
+    value: TValue;
+    originalChallengeParams?: {
+        challenge: string;
+        timestamp: number;
+    };
+};
+type ApiKeyAssertion = BaseAssertion<'API_KEY', ApiKeyValue>;
+type InteractiveAssertion = BaseAssertion<'REDIRECT' | 'OAUTH_REDIRECT' | 'SIGNING_CHALLENGE' | 'WEBAUTHN' | 'OTP' | 'PASSWORD', SigningChallengeValue>;
+type AssertionResult = ApiKeyAssertion | InteractiveAssertion;
+export type UserProfile = {
+    first_name?: string;
+    last_name?: string;
+    /**
+     * ISO 8601 formatted date string (YYYY-MM-DD)
+     */
+    birthdate?: string;
+    email?: string;
+    phone?: string;
+    gender?: string;
+    address_line1?: string;
+    address_line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    neighborhood?: string;
+    country_of_birth_code?: string;
+    country_of_residence_code?: string;
+    personal_id_type?: string;
+    personal_id_number?: string;
+};
+export type BusinessProfile = {
+    /**
+     * Primary business address (street address)
+     */
+    address_line1: string;
+    /**
+     * City where business is registered
+     */
+    city: string;
+    /**
+     * Country of incorporation (full name)
+     */
+    country: string;
+    /**
+     * Date of incorporation or registration (YYYY-MM-DD format)
+     */
+    incorporation_date: string;
+    /**
+     * Official registered legal name of the business
+     */
+    legal_name: string;
+    /**
+     * Business trading name or DBA (Doing Business As)
+     */
+    name: string;
+    /**
+     * Postal or ZIP code
+     */
+    postal_code: string;
+    /**
+     * State, province, or region of registration
+     */
+    state: string;
+    /**
+     * Tax identification number (EIN, VAT, RFC, etc.)
+     */
+    tax_id: string;
+    /**
+     * Business legal structure type (LLC, Corporation, Partnership, etc.)
+     */
+    type: string;
+    /**
+     * Secondary address line (suite, floor, etc.)
+     */
+    address_line2?: string;
+    /**
+     * ISO country code (2 or 3 letters)
+     */
+    country_code?: string;
+    /**
+     * Business contact email
+     */
+    email?: string;
+    /**
+     * URL to business logo image
+     */
+    logo?: string;
+    /**
+     * Owner's primary address
+     */
+    owner_address_line1?: string;
+    /**
+     * Owner's secondary address line
+     */
+    owner_address_line2?: string;
+    /**
+     * Owner's city of residence
+     */
+    owner_city?: string;
+    /**
+     * Owner's country code
+     */
+    owner_country_code?: string;
+    /**
+     * Owner's identification number
+     */
+    owner_id_number?: string;
+    /**
+     * Type of identification document for owner
+     */
+    owner_id_type?: string;
+    /**
+     * Full name of the beneficial owner or primary representative
+     */
+    owner_name?: string;
+    /**
+     * Owner's postal code
+     */
+    owner_postal_code?: string;
+    /**
+     * Owner's state or province
+     */
+    owner_state?: string;
+    /**
+     * Business contact phone number
+     */
+    phone?: string;
+};
+export type IndividualRegisterRequest = {
+    assertion_result: AssertionResult;
+    extra_context?: Record<string, unknown>;
+    type: 'individual';
+    profile: UserProfile;
+};
+export type BusinessRegisterRequest = {
+    assertion_result: AssertionResult;
+    extra_context?: Record<string, unknown>;
+    type: 'business';
+    profile: BusinessProfile;
+};
+export type RegisterRequest = IndividualRegisterRequest | BusinessRegisterRequest;
+export interface RegisterResponse {
+    result: {
+        access_token: string;
+    };
+    req_id: string;
+}
 export {};

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 i in t)__webpack_require__.o(t,i)&&!__webpack_require__.o(e,i)&&Object.defineProperty(e,i,{enumerable:!0,get:t[i]})},__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__,{OriginClient:()=>OriginClient,AliasesClient:()=>AliasesClient,IdentityClient:()=>IdentityClient,OriginsClient:()=>OriginsClient});class AliasesClient{httpClient;constructor(e){this.httpClient=e}async get(e){return await this.httpClient.request({method:"GET",path:`/api/aliases?alias=${e}`})}}class OriginClient{httpClient;origin;constructor(e,t){this.httpClient=e,this.origin=t}async assert(e){return await this.httpClient.request({method:"GET",path:`/api/origins/${this.origin}/assert?alias=${e}`})}}class OriginsClient{whatsapp;email;httpClient;constructor(e){this.httpClient=e,this.whatsapp=new OriginClient(e,"bloque-whatsapp"),this.email=new OriginClient(e,"bloque-email")}custom(e){return new OriginClient(this.httpClient,e)}async list(){return await this.httpClient.request({method:"GET",path:"/api/origins"})}}class IdentityClient{httpClient;aliases;origins;constructor(e){this.httpClient=e,this.aliases=new AliasesClient(this.httpClient),this.origins=new OriginsClient(this.httpClient)}}for(var __rspack_i in exports.AliasesClient=__webpack_exports__.AliasesClient,exports.IdentityClient=__webpack_exports__.IdentityClient,exports.OriginClient=__webpack_exports__.OriginClient,exports.OriginsClient=__webpack_exports__.OriginsClient,__webpack_exports__)-1===["AliasesClient","IdentityClient","OriginClient","OriginsClient"].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 i in t)__webpack_require__.o(t,i)&&!__webpack_require__.o(e,i)&&Object.defineProperty(e,i,{enumerable:!0,get:t[i]})},__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__,{OriginClient:()=>OriginClient,AliasesClient:()=>AliasesClient,IdentityClient:()=>IdentityClient,OriginsClient:()=>OriginsClient});class AliasesClient{httpClient;constructor(e){this.httpClient=e}async get(e){return await this.httpClient.request({method:"GET",path:`/api/aliases?alias=${e}`})}}class OriginClient{httpClient;origin;constructor(e,t){this.httpClient=e,this.origin=t}async assert(e){return await this.httpClient.request({method:"GET",path:`/api/origins/${this.origin}/assert?alias=${e}`})}}class OriginsClient{whatsapp;email;httpClient;constructor(e){this.httpClient=e,this.whatsapp=new OriginClient(e,"bloque-whatsapp"),this.email=new OriginClient(e,"bloque-email")}custom(e){return new OriginClient(this.httpClient,e)}async list(){return await this.httpClient.request({method:"GET",path:"/api/origins"})}async register(e,t){let i,r=t.assertionResult,n="API_KEY"===r.challengeType?{alias:r.alias,challengeType:"API_KEY",value:{api_key:r.value.apiKey,alias:r.value.alias},originalChallengeParams:r.originalChallengeParams}:{alias:r.alias,challengeType:r.challengeType,value:r.value,originalChallengeParams:r.originalChallengeParams};return i="individual"===t.type?{assertion_result:n,extra_context:t.extraContext,type:"individual",profile:this._mapUserProfile(t.profile)}:{assertion_result:n,extra_context:t.extraContext,type:"business",profile:this._mapBusinessProfile(t.profile)},{accessToken:(await this.httpClient.request({method:"POST",path:`/api/origins/${e}/register`,body:i})).result.access_token}}_mapUserProfile(e){return{first_name:e.firstName,last_name:e.lastName,birthdate:e.birthdate,email:e.email,phone:e.phone,gender:e.gender,address_line1:e.addressLine1,address_line2:e.addressLine2,city:e.city,state:e.state,postal_code:e.postalCode,neighborhood:e.neighborhood,country_of_birth_code:e.countryOfBirthCode,country_of_residence_code:e.countryOfResidenceCode,personal_id_type:e.personalIdType,personal_id_number:e.personalIdNumber}}_mapBusinessProfile(e){return{address_line1:e.addressLine1,city:e.city,country:e.country,incorporation_date:e.incorporationDate,legal_name:e.legalName,name:e.name,postal_code:e.postalCode,state:e.state,tax_id:e.taxId,type:e.type,address_line2:e.addressLine2,country_code:e.countryCode,email:e.email,logo:e.logo,owner_address_line1:e.ownerAddressLine1,owner_address_line2:e.ownerAddressLine2,owner_city:e.ownerCity,owner_country_code:e.ownerCountryCode,owner_id_number:e.ownerIdNumber,owner_id_type:e.ownerIdType,owner_name:e.ownerName,owner_postal_code:e.ownerPostalCode,owner_state:e.ownerState,phone:e.phone}}}class IdentityClient{httpClient;aliases;origins;constructor(e){this.httpClient=e,this.aliases=new AliasesClient(this.httpClient),this.origins=new OriginsClient(this.httpClient)}}for(var __rspack_i in exports.AliasesClient=__webpack_exports__.AliasesClient,exports.IdentityClient=__webpack_exports__.IdentityClient,exports.OriginClient=__webpack_exports__.OriginClient,exports.OriginsClient=__webpack_exports__.OriginsClient,__webpack_exports__)-1===["AliasesClient","IdentityClient","OriginClient","OriginsClient"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.d.ts

@@ -4,3 +4,4 @@ export * from './api-types';
 export * from './client';
 export * from './origins/client';
 export * from './origins/origin';
+export * from './origins/types';

package/dist/index.js

@@ -1 +1 @@
-class t{httpClient;constructor(t){this.httpClient=t}async get(t){return await this.httpClient.request({method:"GET",path:`/api/aliases?alias=${t}`})}}class i{httpClient;origin;constructor(t,i){this.httpClient=t,this.origin=i}async assert(t){return await this.httpClient.request({method:"GET",path:`/api/origins/${this.origin}/assert?alias=${t}`})}}class s{whatsapp;email;httpClient;constructor(t){this.httpClient=t,this.whatsapp=new i(t,"bloque-whatsapp"),this.email=new i(t,"bloque-email")}custom(t){return new i(this.httpClient,t)}async list(){return await this.httpClient.request({method:"GET",path:"/api/origins"})}}class e{httpClient;aliases;origins;constructor(i){this.httpClient=i,this.aliases=new t(this.httpClient),this.origins=new s(this.httpClient)}}export{t as AliasesClient,e as IdentityClient,i as OriginClient,s as OriginsClient};
+class e{httpClient;constructor(e){this.httpClient=e}async get(e){return await this.httpClient.request({method:"GET",path:`/api/aliases?alias=${e}`})}}class t{httpClient;origin;constructor(e,t){this.httpClient=e,this.origin=t}async assert(e){return await this.httpClient.request({method:"GET",path:`/api/origins/${this.origin}/assert?alias=${e}`})}}class i{whatsapp;email;httpClient;constructor(e){this.httpClient=e,this.whatsapp=new t(e,"bloque-whatsapp"),this.email=new t(e,"bloque-email")}custom(e){return new t(this.httpClient,e)}async list(){return await this.httpClient.request({method:"GET",path:"/api/origins"})}async register(e,t){let i,a=t.assertionResult,n="API_KEY"===a.challengeType?{alias:a.alias,challengeType:"API_KEY",value:{api_key:a.value.apiKey,alias:a.value.alias},originalChallengeParams:a.originalChallengeParams}:{alias:a.alias,challengeType:a.challengeType,value:a.value,originalChallengeParams:a.originalChallengeParams};return i="individual"===t.type?{assertion_result:n,extra_context:t.extraContext,type:"individual",profile:this._mapUserProfile(t.profile)}:{assertion_result:n,extra_context:t.extraContext,type:"business",profile:this._mapBusinessProfile(t.profile)},{accessToken:(await this.httpClient.request({method:"POST",path:`/api/origins/${e}/register`,body:i})).result.access_token}}_mapUserProfile(e){return{first_name:e.firstName,last_name:e.lastName,birthdate:e.birthdate,email:e.email,phone:e.phone,gender:e.gender,address_line1:e.addressLine1,address_line2:e.addressLine2,city:e.city,state:e.state,postal_code:e.postalCode,neighborhood:e.neighborhood,country_of_birth_code:e.countryOfBirthCode,country_of_residence_code:e.countryOfResidenceCode,personal_id_type:e.personalIdType,personal_id_number:e.personalIdNumber}}_mapBusinessProfile(e){return{address_line1:e.addressLine1,city:e.city,country:e.country,incorporation_date:e.incorporationDate,legal_name:e.legalName,name:e.name,postal_code:e.postalCode,state:e.state,tax_id:e.taxId,type:e.type,address_line2:e.addressLine2,country_code:e.countryCode,email:e.email,logo:e.logo,owner_address_line1:e.ownerAddressLine1,owner_address_line2:e.ownerAddressLine2,owner_city:e.ownerCity,owner_country_code:e.ownerCountryCode,owner_id_number:e.ownerIdNumber,owner_id_type:e.ownerIdType,owner_name:e.ownerName,owner_postal_code:e.ownerPostalCode,owner_state:e.ownerState,phone:e.phone}}}class a{httpClient;aliases;origins;constructor(t){this.httpClient=t,this.aliases=new e(this.httpClient),this.origins=new i(this.httpClient)}}export{e as AliasesClient,a as IdentityClient,t as OriginClient,i as OriginsClient};

package/dist/origins/client.d.ts

@@ -1,6 +1,7 @@
 import type { HttpClient } from '@bloque/sdk-core';
 import type { Origin, OTPAssertion, OTPAssertionEmail, OTPAssertionWhatsApp } from '../api-types';
 import { OriginClient } from './origin';
+import type { RegisterParams, RegisterResult } from './types';
 export declare class OriginsClient {
     readonly whatsapp: OriginClient<OTPAssertionWhatsApp>;
     readonly email: OriginClient<OTPAssertionEmail>;
@@ -28,4 +29,92 @@ export declare class OriginsClient {
      * ```
      */
     list(): Promise<Origin[]>;
+    /**
+     * Register a new user or business identity to a specific origin
+     *
+     * Creates a new identity by verifying the assertion result (challenge response)
+     * and storing the profile information. Supports both individual users (KYC) and
+     * businesses (KYB) registration.
+     *
+     * Different origins support different challenge types:
+     * - **SIGNING_CHALLENGE**: Blockchain signature verification (e.g., Ethereum, Solana)
+     * - **API_KEY**: Traditional API key authentication
+     * - **OAUTH_REDIRECT**: OAuth-based authentication flows
+     * - **WEBAUTHN**: WebAuthn/passkey authentication
+     * - **OTP**: One-time password verification
+     * - **PASSWORD**: Password-based authentication
+     *
+     * @param origin - The origin namespace to register the identity to (e.g., 'ethereum-mainnet', 'bloque-api')
+     * @param params - Registration data including assertion result and profile information
+     * @returns Promise resolving to the registration result with access token
+     *
+     * @example
+     * ```typescript
+     * // Register individual user with blockchain signature (KYC)
+     * const individual = await bloque.identity.origins.register('ethereum-mainnet', {
+     *   assertionResult: {
+     *     alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
+     *     challengeType: 'SIGNING_CHALLENGE',
+     *     value: {
+     *       signature: '0x1234567890abcdef...',
+     *       alias: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6'
+     *     },
+     *     originalChallengeParams: {
+     *       challenge: 'bloque-challenge-1234567890',
+     *       timestamp: 1640995200
+     *     }
+     *   },
+     *   type: 'individual',
+     *   profile: {
+     *     firstName: 'John',
+     *     lastName: 'Doe',
+     *     email: 'john.doe@example.com',
+     *     phone: '+1234567890',
+     *     birthdate: '1990-01-15',
+     *     city: 'New York',
+     *     state: 'NY',
+     *     postalCode: '10001',
+     *     countryOfBirthCode: 'USA',
+     *     countryOfResidenceCode: 'USA'
+     *   }
+     * });
+     *
+     * // Register business with API key (KYB)
+     * const business = await bloque.identity.origins.register('bloque-api', {
+     *   assertionResult: {
+     *     alias: 'business-123',
+     *     challengeType: 'API_KEY',
+     *     value: {
+     *       apiKey: 'sk_live_abc123def456',
+     *       alias: 'business-123'
+     *     }
+     *   },
+     *   type: 'business',
+     *   profile: {
+     *     legalName: 'Acme Corporation',
+     *     name: 'Acme Corp',
+     *     taxId: '12-3456789',
+     *     type: 'LLC',
+     *     incorporationDate: '2020-01-15',
+     *     addressLine1: '123 Business St',
+     *     city: 'New York',
+     *     state: 'NY',
+     *     postalCode: '10001',
+     *     country: 'United States',
+     *     email: 'contact@acme.com',
+     *     phone: '+1-555-0123',
+     *     ownerName: 'Jane Smith',
+     *     ownerIdType: 'SSN',
+     *     ownerIdNumber: '123-45-6789'
+     *   }
+     * });
+     *
+     * // Access tokens for authenticated sessions
+     * console.log(individual.accessToken); // JWT token for individual
+     * console.log(business.accessToken); // JWT token for business
+     * ```
+     */
+    register(origin: string, params: RegisterParams): Promise<RegisterResult>;
+    private _mapUserProfile;
+    private _mapBusinessProfile;
 }

package/dist/origins/types.d.ts

@@ -0,0 +1,195 @@
+export interface SigningChallengeValue {
+    /**
+     * The cryptographic signature
+     */
+    signature: string;
+    /**
+     * The alias being verified
+     */
+    alias: string;
+}
+export interface ApiKeyValue {
+    /**
+     * API key for authentication
+     */
+    apiKey: string;
+    /**
+     * The alias being verified
+     */
+    alias: string;
+}
+type BaseAssertion<TType extends string, TValue> = {
+    alias: string;
+    challengeType: TType;
+    value: TValue;
+    originalChallengeParams?: {
+        challenge: string;
+        timestamp: number;
+    };
+};
+type ApiKeyAssertion = BaseAssertion<'API_KEY', ApiKeyValue>;
+type InteractiveAssertion = BaseAssertion<'REDIRECT' | 'OAUTH_REDIRECT' | 'SIGNING_CHALLENGE' | 'WEBAUTHN' | 'OTP' | 'PASSWORD', SigningChallengeValue>;
+type AssertionResult = ApiKeyAssertion | InteractiveAssertion;
+interface UserProfile {
+    firstName?: string;
+    lastName?: string;
+    /**
+     * ISO 8601 formatted date string (YYYY-MM-DD)
+     */
+    birthdate?: string;
+    email?: string;
+    phone?: string;
+    gender?: string;
+    addressLine1?: string;
+    addressLine2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    neighborhood?: string;
+    countryOfBirthCode?: string;
+    countryOfResidenceCode?: string;
+    personalIdType?: string;
+    personalIdNumber?: string;
+}
+interface BusinessProfile {
+    /**
+     * Primary business address (street address)
+     */
+    addressLine1: string;
+    /**
+     * City where business is registered
+     */
+    city: string;
+    /**
+     * Country of incorporation (full name)
+     */
+    country: string;
+    /**
+     * Date of incorporation or registration (YYYY-MM-DD format)
+     */
+    incorporationDate: string;
+    /**
+     * Official registered legal name of the business
+     */
+    legalName: string;
+    /**
+     * Business trading name or DBA (Doing Business As)
+     */
+    name: string;
+    /**
+     * Postal or ZIP code
+     */
+    postalCode: string;
+    /**
+     * State, province, or region of registration
+     */
+    state: string;
+    /**
+     * Tax identification number (EIN, VAT, RFC, etc.)
+     */
+    taxId: string;
+    /**
+     * Business legal structure type (LLC, Corporation, Partnership, etc.)
+     */
+    type: string;
+    /**
+     * Secondary address line (suite, floor, etc.)
+     */
+    addressLine2?: string;
+    /**
+     * ISO country code (2 or 3 letters)
+     */
+    countryCode?: string;
+    /**
+     * Business contact email
+     */
+    email?: string;
+    /**
+     * URL to business logo image
+     */
+    logo?: string;
+    /**
+     * Owner's primary address
+     */
+    ownerAddressLine1?: string;
+    /**
+     * Owner's secondary address line
+     */
+    ownerAddressLine2?: string;
+    /**
+     * Owner's city of residence
+     */
+    ownerCity?: string;
+    /**
+     * Owner's country code
+     */
+    ownerCountryCode?: string;
+    /**
+     * Owner's identification number
+     */
+    ownerIdNumber?: string;
+    /**
+     * Type of identification document for owner
+     */
+    ownerIdType?: string;
+    /**
+     * Full name of the beneficial owner or primary representative
+     */
+    ownerName?: string;
+    /**
+     * Owner's postal code
+     */
+    ownerPostalCode?: string;
+    /**
+     * Owner's state or province
+     */
+    ownerState?: string;
+    /**
+     * Business contact phone number
+     */
+    phone?: string;
+}
+export interface IndividualRegisterParams {
+    /**
+     * Result of the assertion challenge
+     */
+    assertionResult: AssertionResult;
+    /**
+     * Additional context data
+     */
+    extraContext?: Record<string, unknown>;
+    /**
+     * Type of entity being registered
+     */
+    type: 'individual';
+    /**
+     * User profile information
+     */
+    profile: UserProfile;
+}
+export interface BusinessRegisterParams {
+    /**
+     * Result of the assertion challenge
+     */
+    assertionResult: AssertionResult;
+    /**
+     * Additional context data
+     */
+    extraContext?: Record<string, unknown>;
+    /**
+     * Type of entity being registered
+     */
+    type: 'business';
+    /**
+     * Business profile information
+     */
+    profile: BusinessProfile;
+}
+export type RegisterParams = IndividualRegisterParams | BusinessRegisterParams;
+export interface RegisterResult {
+    /**
+     * JWT access token for the registered identity
+     */
+    accessToken: string;
+}
+export {};

package/package.json

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