@23blocks/sdk 4.4.0 → 5.0.1

package/README.md

@@ -0,0 +1,473 @@
+# @23blocks/sdk
+
+The complete 23blocks SDK - all blocks in a single package with automatic token management.
+
+[![npm version](https://img.shields.io/npm/v/@23blocks/sdk.svg)](https://www.npmjs.com/package/@23blocks/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+npm install @23blocks/sdk
+```
+
+## Overview
+
+This is the recommended package for most users. It provides:
+
+- **All blocks** - Every 23blocks feature in one package
+- **Simple client** - Single factory function to create the client
+- **Token management** - Automatic token storage and refresh
+- **Type safety** - Full TypeScript support
+
+## Quick Start
+
+```typescript
+import { create23BlocksClient } from '@23blocks/sdk';
+
+// Create client with service URLs
+const client = create23BlocksClient({
+  apiKey: 'your-api-key',
+  urls: {
+    authentication: 'https://auth.yourapp.com',
+    // Add other services as needed
+    // products: 'https://products.yourapp.com',
+    // crm: 'https://crm.yourapp.com',
+  },
+});
+
+// Sign in - tokens are stored automatically
+const { user } = await client.auth.signIn({
+  email: 'user@example.com',
+  password: 'password',
+});
+console.log('Welcome', user.email);
+
+// All subsequent requests include auth automatically
+const currentUser = await client.auth.getCurrentUser();
+
+// Sign out - tokens are cleared automatically
+await client.auth.signOut();
+```
+
+## Configuration
+
+### ClientConfig Options
+
+```typescript
+const client = create23BlocksClient({
+  // Required: Service URLs (only configure what you need)
+  urls: {
+    authentication: 'https://auth.yourapp.com',
+    products: 'https://products.yourapp.com',
+    crm: 'https://crm.yourapp.com',
+    // ... other services
+  },
+
+  // Required: Your API key
+  apiKey: 'your-api-key',
+
+  // Optional: Tenant ID for multi-tenant setups
+  tenantId: 'tenant-123',
+
+  // Optional: Authentication mode (default: 'token')
+  authMode: 'token', // 'token' | 'cookie'
+
+  // Optional: Token storage (default: 'localStorage' in browser, 'memory' in SSR)
+  storage: 'localStorage', // 'localStorage' | 'sessionStorage' | 'memory'
+
+  // Optional: Additional headers for every request
+  headers: { 'X-Custom-Header': 'value' },
+
+  // Optional: Request timeout in milliseconds (default: 30000)
+  timeout: 30000,
+});
+```
+
+### Service URLs
+
+Each microservice has its own URL. Only configure the services you need:
+
+```typescript
+interface ServiceUrls {
+  authentication?: string;  // Auth, users, roles
+  search?: string;          // Search, favorites
+  products?: string;        // Products, cart, catalog
+  crm?: string;             // Contacts, leads, opportunities
+  content?: string;         // CMS posts, comments
+  geolocation?: string;     // Addresses, locations
+  conversations?: string;   // Messages, notifications
+  files?: string;           // File uploads
+  forms?: string;           // Form builder
+  assets?: string;          // Asset tracking
+  campaigns?: string;       // Marketing campaigns
+  company?: string;         // Company settings
+  rewards?: string;         // Rewards, loyalty
+  sales?: string;           // Orders, payments
+  wallet?: string;          // Digital wallet
+  jarvis?: string;          // AI assistant
+  onboarding?: string;      // User onboarding
+  university?: string;      // Learning management
+}
+```
+
+> **Note:** Accessing a service without a configured URL will throw an error with a helpful message.
+
+### Token Mode (Default)
+
+Tokens are stored in browser storage and attached to requests automatically:
+
+```typescript
+const client = create23BlocksClient({
+  apiKey: 'your-api-key',
+  urls: { authentication: 'https://auth.yourapp.com' },
+  authMode: 'token',        // default
+  storage: 'localStorage',  // default in browser
+});
+```
+
+### Cookie Mode (Recommended for Security)
+
+Backend manages authentication via httpOnly cookies:
+
+```typescript
+const client = create23BlocksClient({
+  apiKey: 'your-api-key',
+  urls: { authentication: 'https://auth.yourapp.com' },
+  authMode: 'cookie',
+});
+```
+
+### SSR / Server-Side Usage
+
+For server-side rendering, use memory storage and pass tokens manually:
+
+```typescript
+const client = create23BlocksClient({
+  apiKey: 'your-api-key',
+  urls: { authentication: 'https://auth.yourapp.com' },
+  storage: 'memory',
+  headers: {
+    Authorization: `Bearer ${tokenFromRequest}`,
+  },
+});
+```
+
+### Multi-Tenant Setup
+
+```typescript
+const client = create23BlocksClient({
+  apiKey: 'your-api-key',
+  urls: { authentication: 'https://auth.yourapp.com' },
+  tenantId: 'tenant-123',
+});
+```
+
+## Authentication
+
+### Sign In
+
+```typescript
+// Required: email, password
+const { user, accessToken, refreshToken, expiresIn } = await client.auth.signIn({
+  email: 'user@example.com',
+  password: 'password',
+});
+
+// In token mode, tokens are automatically stored
+// In cookie mode, backend sets httpOnly cookies
+```
+
+### Sign Up (Registration)
+
+```typescript
+// Sign up with required fields only
+const { user, accessToken, message } = await client.auth.signUp({
+  email: 'new@example.com',         // Required
+  password: 'password',              // Required
+  passwordConfirmation: 'password',  // Required - must match password
+});
+
+// Sign up with optional fields
+const { user, accessToken, message } = await client.auth.signUp({
+  // Required
+  email: 'new@example.com',
+  password: 'password',
+  passwordConfirmation: 'password',
+
+  // Optional
+  name: 'John Doe',
+  username: 'johndoe',
+  roleId: 'role-uuid',
+  confirmSuccessUrl: 'https://yourapp.com/confirmed',  // Redirect after email confirmation
+  timeZone: 'America/New_York',
+  preferredLanguage: 'en',
+  payload: { referralCode: 'ABC123' },  // Custom data
+  subscription: 'premium-plan',          // Subscription model ID
+});
+```
+
+> **Note:** If email confirmation is enabled, `accessToken` will be `undefined`. The user must confirm their email before signing in.
+
+### Sign Out
+
+```typescript
+await client.auth.signOut();
+// Tokens are automatically cleared (token mode) or cookies invalidated (cookie mode)
+```
+
+### Get Current User
+
+```typescript
+const user = await client.auth.getCurrentUser();
+// Returns user with role, avatar, and profile included
+```
+
+### Email Confirmation
+
+```typescript
+// Confirm email with token from email link
+const user = await client.auth.confirmEmail('confirmation-token');
+
+// Resend confirmation email
+await client.auth.resendConfirmation({
+  email: 'user@example.com',
+  confirmSuccessUrl: 'https://yourapp.com/confirmed',  // Optional
+});
+```
+
+### Password Reset
+
+```typescript
+// Request password reset email
+await client.auth.requestPasswordReset({
+  email: 'user@example.com',
+  redirectUrl: 'https://yourapp.com/reset',  // Optional
+});
+
+// Update password with reset token
+await client.auth.updatePassword({
+  password: 'newPassword',
+  passwordConfirmation: 'newPassword',
+  resetPasswordToken: 'token-from-email',
+});
+```
+
+### Token Utilities
+
+```typescript
+// Check if authenticated (token mode only, returns null in cookie mode)
+const isLoggedIn = client.isAuthenticated();
+
+// Get tokens manually (token mode only)
+const accessToken = client.getAccessToken();
+const refreshToken = client.getRefreshToken();
+
+// Set tokens manually (useful for SSR hydration)
+client.setTokens(accessToken, refreshToken);
+
+// Clear session
+client.clearSession();
+```
+
+## Available Blocks
+
+The client provides access to all blocks:
+
+| Block | Description |
+|-------|-------------|
+| `client.auth` | Authentication with managed tokens |
+| `client.authentication` | Full authentication block |
+| `client.search` | Search and favorites |
+| `client.products` | Products, categories, cart |
+| `client.crm` | CRM - contacts, accounts, leads |
+| `client.content` | CMS - posts, comments |
+| `client.geolocation` | Addresses, locations |
+| `client.conversations` | Messages, notifications |
+| `client.files` | File uploads |
+| `client.forms` | Form builder |
+| `client.assets` | Asset tracking |
+| `client.campaigns` | Marketing campaigns |
+| `client.company` | Company settings |
+| `client.rewards` | Rewards and loyalty |
+| `client.sales` | Orders and payments |
+| `client.wallet` | Digital wallet |
+| `client.jarvis` | AI assistant |
+| `client.onboarding` | User onboarding |
+| `client.university` | Learning management |
+
+## Usage Examples
+
+### Products
+
+```typescript
+// Requires urls.products to be configured
+const { data: products, meta } = await client.products.products.list({
+  limit: 20,
+  categoryId: 'category-123',
+});
+
+// Get product
+const product = await client.products.products.get('product-id');
+
+// Add to cart
+const cart = await client.products.cart.addItem({
+  productId: 'product-id',
+  quantity: 2,
+});
+
+// Checkout
+const order = await client.products.cart.checkout({
+  shippingAddressId: 'address-id',
+  paymentMethodId: 'payment-id',
+});
+```
+
+### Search
+
+```typescript
+// Requires urls.search to be configured
+const { results, totalRecords } = await client.search.search.search({
+  query: 'laptop',
+  limit: 20,
+});
+
+// Suggestions
+const suggestions = await client.search.search.suggest('lap', 5);
+
+// Favorites
+await client.search.favorites.add({
+  entityUniqueId: 'product-123',
+  entityType: 'Product',
+});
+
+const { data: favorites } = await client.search.favorites.list();
+```
+
+### CRM
+
+```typescript
+// Requires urls.crm to be configured
+const { data: contacts } = await client.crm.contacts.list({ limit: 20 });
+
+// Create lead
+const lead = await client.crm.leads.create({
+  firstName: 'John',
+  lastName: 'Doe',
+  email: 'john@example.com',
+});
+
+// Create opportunity
+const opp = await client.crm.opportunities.create({
+  name: 'Enterprise Deal',
+  accountId: 'account-id',
+  value: 50000,
+});
+```
+
+## Error Handling
+
+```typescript
+import { isBlockErrorException, ErrorCodes } from '@23blocks/sdk';
+
+try {
+  await client.auth.signIn({ email, password });
+} catch (error) {
+  if (isBlockErrorException(error)) {
+    switch (error.code) {
+      case ErrorCodes.INVALID_CREDENTIALS:
+        console.log('Invalid email or password');
+        break;
+      case ErrorCodes.UNAUTHORIZED:
+        console.log('Session expired');
+        break;
+      case ErrorCodes.VALIDATION_ERROR:
+        console.log('Validation error:', error.message);
+        break;
+      case ErrorCodes.NETWORK_ERROR:
+        console.log('Network error');
+        break;
+      default:
+        console.log(error.message);
+    }
+  }
+}
+```
+
+## Advanced: Custom Transport
+
+For advanced users who need custom transport configuration:
+
+```typescript
+import { createHttpTransport, createAuthenticationBlock } from '@23blocks/sdk';
+
+const transport = createHttpTransport({
+  baseUrl: 'https://auth.yourapp.com',
+  headers: () => {
+    const token = localStorage.getItem('access_token');
+    return {
+      'api-key': 'your-api-key',
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+    };
+  },
+  timeout: 60000,
+});
+
+const auth = createAuthenticationBlock(transport, {
+  apiKey: 'your-api-key',
+});
+
+// Use the block directly
+const { user } = await auth.auth.signIn({ email, password });
+```
+
+## TypeScript
+
+All types are exported and can be used directly:
+
+```typescript
+import type {
+  // Client types
+  Blocks23Client,
+  ClientConfig,
+  ServiceUrls,
+  AuthMode,
+  StorageType,
+
+  // Auth types
+  User,
+  SignInRequest,
+  SignInResponse,
+  SignUpRequest,
+  SignUpResponse,
+
+  // Product types
+  Product,
+  Cart,
+
+  // Core types
+  PageResult,
+  BlockError,
+} from '@23blocks/sdk';
+```
+
+## Framework-Specific Packages
+
+For framework-specific features:
+
+- [`@23blocks/angular`](https://www.npmjs.com/package/@23blocks/angular) - Injectable services with RxJS
+- [`@23blocks/react`](https://www.npmjs.com/package/@23blocks/react) - React hooks and context
+
+## Individual Blocks
+
+If you only need specific functionality, install individual blocks:
+
+```bash
+npm install @23blocks/transport-http @23blocks/block-authentication @23blocks/block-search
+```
+
+See the [main README](https://github.com/23blocks-OS/frontend-sdk) for the complete list of available packages.
+
+## License
+
+MIT - Copyright (c) 2024 23blocks

package/dist/index.esm.js

@@ -41,9 +41,9 @@ export * from '@23blocks/contracts';
 export * from '@23blocks/jsonapi-codec';
 
 /**
- * Generate storage key scoped to app and tenant
- */ function getStorageKey(type, appId, tenantId) {
-    const scope = tenantId ? `${appId}_${tenantId}` : appId;
+ * Generate storage key scoped to API key and tenant
+ */ function getStorageKey(type, apiKey, tenantId) {
+    const scope = tenantId ? `${apiKey}_${tenantId}` : apiKey;
     return `23blocks_${scope}_${type}_token`;
 }
 /**
@@ -89,13 +89,13 @@ export * from '@23blocks/jsonapi-codec';
 /**
  * Create a token manager instance
  *
- * @param config - Token manager configuration including appId for scoped storage
+ * @param config - Token manager configuration including apiKey for scoped storage
  * @returns A TokenManager instance
  *
  * @example
  * ```typescript
  * const tokenManager = createTokenManager({
- *   appId: 'my-app',
+ *   apiKey: 'my-api-key',
  *   storage: 'localStorage',
  * });
  *
@@ -114,10 +114,10 @@ export * from '@23blocks/jsonapi-codec';
  * });
  * ```
  */ function createTokenManager(config) {
-    const { appId, tenantId, storage: storageType = 'localStorage' } = config;
+    const { apiKey, tenantId, storage: storageType = 'localStorage' } = config;
     const storage = getStorage(storageType);
-    const accessTokenKey = getStorageKey('access', appId, tenantId);
-    const refreshTokenKey = getStorageKey('refresh', appId, tenantId);
+    const accessTokenKey = getStorageKey('access', apiKey, tenantId);
+    const refreshTokenKey = getStorageKey('refresh', apiKey, tenantId);
     // Track storage event listeners for cleanup
     const listeners = new Set();
     return {
@@ -191,7 +191,7 @@ export * from '@23blocks/jsonapi-codec';
  * @example Basic usage with multiple services
  * ```typescript
  * const client = create23BlocksClient({
- *   appId: 'your-app-id',
+ *   apiKey: 'your-api-key',
  *   urls: {
  *     authentication: 'https://gateway.23blocks.com',
  *     crm: 'https://crm.23blocks.com',
@@ -213,7 +213,7 @@ export * from '@23blocks/jsonapi-codec';
  * @example Cookie mode (recommended for security)
  * ```typescript
  * const client = create23BlocksClient({
- *   appId: 'your-app-id',
+ *   apiKey: 'your-api-key',
  *   authMode: 'cookie',
  *   urls: {
  *     authentication: 'https://gateway.23blocks.com',
@@ -225,7 +225,7 @@ export * from '@23blocks/jsonapi-codec';
  * @example SSR with token forwarding
  * ```typescript
  * const client = create23BlocksClient({
- *   appId: 'your-app-id',
+ *   apiKey: 'your-api-key',
  *   storage: 'memory',
  *   headers: { Authorization: `Bearer ${tokenFromRequest}` },
  *   urls: {
@@ -235,12 +235,12 @@ export * from '@23blocks/jsonapi-codec';
  * });
  * ```
  */ function create23BlocksClient(config) {
-    const { urls, appId, tenantId, authMode = 'token', storage = isBrowser() ? 'localStorage' : 'memory', headers: staticHeaders = {}, timeout } = config;
+    const { urls, apiKey, tenantId, authMode = 'token', storage = isBrowser() ? 'localStorage' : 'memory', headers: staticHeaders = {}, timeout } = config;
     // Create token manager for token mode
     let tokenManager = null;
     if (authMode === 'token') {
         tokenManager = createTokenManager({
-            appId,
+            apiKey,
             tenantId,
             storage
         });
@@ -253,7 +253,7 @@ export * from '@23blocks/jsonapi-codec';
             credentials: authMode === 'cookie' ? 'include' : undefined,
             headers: ()=>{
                 const headers = _({}, staticHeaders, {
-                    appid: appId
+                    'api-key': apiKey
                 });
                 if (tenantId) {
                     headers['tenant-id'] = tenantId;
@@ -279,7 +279,7 @@ export * from '@23blocks/jsonapi-codec';
     }
     // Create block config
     const blockConfig = {
-        appId,
+        apiKey,
         tenantId
     };
     // Create blocks only if their URL is provided

package/dist/src/lib/client.d.ts

@@ -85,9 +85,9 @@ export interface ClientConfig {
      */
     urls: ServiceUrls;
     /**
-     * Application ID
+     * API Key for authenticating with 23blocks services
      */
-    appId: string;
+    apiKey: string;
     /**
      * Tenant ID (optional, for multi-tenant setups)
      */
@@ -292,7 +292,7 @@ export interface Blocks23Client {
  * @example Basic usage with multiple services
  * ```typescript
  * const client = create23BlocksClient({
- *   appId: 'your-app-id',
+ *   apiKey: 'your-api-key',
  *   urls: {
  *     authentication: 'https://gateway.23blocks.com',
  *     crm: 'https://crm.23blocks.com',
@@ -314,7 +314,7 @@ export interface Blocks23Client {
  * @example Cookie mode (recommended for security)
  * ```typescript
  * const client = create23BlocksClient({
- *   appId: 'your-app-id',
+ *   apiKey: 'your-api-key',
  *   authMode: 'cookie',
  *   urls: {
  *     authentication: 'https://gateway.23blocks.com',
@@ -326,7 +326,7 @@ export interface Blocks23Client {
  * @example SSR with token forwarding
  * ```typescript
  * const client = create23BlocksClient({
- *   appId: 'your-app-id',
+ *   apiKey: 'your-api-key',
  *   storage: 'memory',
  *   headers: { Authorization: `Bearer ${tokenFromRequest}` },
  *   urls: {

package/dist/src/lib/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/lib/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/lib/client.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/token-manager.d.ts

@@ -7,10 +7,10 @@ export type StorageType = 'localStorage' | 'sessionStorage' | 'memory';
  */
 export interface TokenManagerConfig {
     /**
-     * Application ID - used to scope token storage
+     * API Key - used to scope token storage
      * This ensures multiple apps on the same domain don't conflict
      */
-    appId: string;
+    apiKey: string;
     /**
      * Tenant ID (optional) - further scopes token storage for multi-tenant apps
      */
@@ -50,13 +50,13 @@ export interface TokenManager {
 /**
  * Create a token manager instance
  *
- * @param config - Token manager configuration including appId for scoped storage
+ * @param config - Token manager configuration including apiKey for scoped storage
  * @returns A TokenManager instance
  *
  * @example
  * ```typescript
  * const tokenManager = createTokenManager({
- *   appId: 'my-app',
+ *   apiKey: 'my-api-key',
  *   storage: 'localStorage',
  * });
  *

package/dist/src/lib/token-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/token-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAyDD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAwE3E"}
+{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/token-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5D;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAyDD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAwE3E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@23blocks/sdk",
-  "version": "4.4.0",
+  "version": "5.0.1",
   "description": "23blocks SDK - unified meta-package re-exporting all blocks and utilities",
   "license": "MIT",
   "author": "23blocks <hello@23blocks.com>",