@explorins/pers-sdk 1.6.43 → 1.6.47

package/dist/index.cjs

@@ -1,21 +1,22 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-XbARV58g.cjs');
+var persSdk = require('./chunks/pers-sdk-DULFjOW2.cjs');
 var index = require('./chunks/index-B6-bbNnd.cjs');
+var web3ChainService = require('./chunks/web3-chain-service-6vsVHPjl.cjs');
 var persShared = require('@explorins/pers-shared');
-var businessService = require('./chunks/business-service-P9o4cwQL.cjs');
+var business = require('./business.cjs');
 var transactionService = require('./chunks/transaction-service-CXjTHCFu.cjs');
+var transactionRequest_builder = require('./chunks/transaction-request.builder-DrqTWcyC.cjs');
 var analyticsService = require('./chunks/analytics-service-CitlimKJ.cjs');
-var campaignService = require('./chunks/campaign-service-B1tQMNqA.cjs');
+var campaignService = require('./chunks/campaign-service-D-v9ZlUB.cjs');
 var donationService = require('./chunks/donation-service-D-xFrONi.cjs');
 var paymentService = require('./chunks/payment-service-B4qx0qiE.cjs');
 var redemptionService = require('./chunks/redemption-service-7qbeQxEM.cjs');
 var tenantService = require('./chunks/tenant-service-DME24vr1.cjs');
 var baseTokenService = require('./chunks/base-token-service-CYuqPPs0.cjs');
 var tokenService = require('./chunks/token-service-BWScn8Qa.cjs');
-var userService = require('./chunks/user-service-D1Rn4U8u.cjs');
+var userService = require('./chunks/user-service-B89wBOV1.cjs');
 var userStatus = require('./user-status.cjs');
-var web3ChainService = require('./chunks/web3-chain-service-BLFxB5TA.cjs');
 var index$1 = require('./chunks/index-CMk3Aqkk.cjs');
 var explorer_utils = require('./chunks/explorer.utils-Cx3wrqAj.cjs');
 var platformAdapters = require('./platform-adapters.cjs');
@@ -49,9 +50,13 @@ exports.IndexedDBTokenStorage = persSdk.IndexedDBTokenStorage;
 exports.LocalStorageTokenStorage = persSdk.LocalStorageTokenStorage;
 exports.MemoryTokenStorage = persSdk.MemoryTokenStorage;
 exports.PersApiClient = persSdk.PersApiClient;
+exports.PersEventEmitter = persSdk.PersEventEmitter;
 exports.PersSDK = persSdk.PersSDK;
 exports.PurchaseManager = persSdk.PurchaseManager;
 exports.RedemptionManager = persSdk.RedemptionManager;
+exports.SDK_NAME = persSdk.SDK_NAME;
+exports.SDK_USER_AGENT = persSdk.SDK_USER_AGENT;
+exports.SDK_VERSION = persSdk.SDK_VERSION;
 exports.TenantManager = persSdk.TenantManager;
 exports.TokenManager = persSdk.TokenManager;
 exports.TransactionManager = persSdk.TransactionManager;
@@ -68,6 +73,17 @@ exports.warnIfProblematicEnvironment = persSdk.warnIfProblematicEnvironment;
 exports.CacheService = index.CacheService;
 exports.CacheTTL = index.CacheTTL;
 exports.globalCacheService = index.globalCacheService;
+exports.ApiErrorDetector = web3ChainService.ApiErrorDetector;
+exports.AuthenticationError = web3ChainService.AuthenticationError;
+exports.ErrorUtils = web3ChainService.ErrorUtils;
+exports.LogoutRequired = web3ChainService.LogoutRequired;
+exports.MultipleContextSelectionRequiredError = web3ChainService.MultipleContextSelectionRequiredError;
+exports.NetworkError = web3ChainService.NetworkError;
+exports.PersApiError = web3ChainService.PersApiError;
+exports.ProviderTokenRefreshNeeded = web3ChainService.ProviderTokenRefreshNeeded;
+exports.TokenRefreshNeeded = web3ChainService.TokenRefreshNeeded;
+exports.Web3ChainApi = web3ChainService.Web3ChainApi;
+exports.Web3ChainService = web3ChainService.Web3ChainService;
 Object.defineProperty(exports, "AccountOwnerType", {
 	enumerable: true,
 	get: function () { return persShared.AccountOwnerType; }
@@ -76,14 +92,34 @@ Object.defineProperty(exports, "ApiKeyType", {
 	enumerable: true,
 	get: function () { return persShared.ApiKeyType; }
 });
+Object.defineProperty(exports, "MEMBERSHIP_ROLE_HIERARCHY", {
+	enumerable: true,
+	get: function () { return persShared.MEMBERSHIP_ROLE_HIERARCHY; }
+});
+Object.defineProperty(exports, "MembershipRole", {
+	enumerable: true,
+	get: function () { return persShared.MembershipRole; }
+});
 Object.defineProperty(exports, "NativeTokenTypes", {
 	enumerable: true,
 	get: function () { return persShared.NativeTokenTypes; }
 });
-exports.BusinessApi = businessService.BusinessApi;
-exports.BusinessService = businessService.BusinessService;
+Object.defineProperty(exports, "hasMinimumRole", {
+	enumerable: true,
+	get: function () { return persShared.hasMinimumRole; }
+});
+exports.BusinessApi = business.BusinessApi;
+exports.BusinessMembershipApi = business.BusinessMembershipApi;
+exports.BusinessMembershipService = business.BusinessMembershipService;
+exports.BusinessService = business.BusinessService;
 exports.TransactionApi = transactionService.TransactionApi;
 exports.TransactionService = transactionService.TransactionService;
+exports.buildBurnRequest = transactionRequest_builder.buildBurnRequest;
+exports.buildMintRequest = transactionRequest_builder.buildMintRequest;
+exports.buildPOSBurnRequest = transactionRequest_builder.buildPOSBurnRequest;
+exports.buildPOSTransferRequest = transactionRequest_builder.buildPOSTransferRequest;
+exports.buildSubmissionRequest = transactionRequest_builder.buildSubmissionRequest;
+exports.buildTransferRequest = transactionRequest_builder.buildTransferRequest;
 exports.AnalyticsApi = analyticsService.AnalyticsApi;
 exports.AnalyticsService = analyticsService.AnalyticsService;
 exports.CampaignApi = campaignService.CampaignApi;
@@ -105,8 +141,6 @@ exports.UserService = userService.UserService;
 exports.UserStatusApi = userStatus.UserStatusApi;
 exports.UserStatusService = userStatus.UserStatusService;
 exports.createUserStatusSDK = userStatus.createUserStatusSDK;
-exports.Web3ChainApi = web3ChainService.Web3ChainApi;
-exports.Web3ChainService = web3ChainService.Web3ChainService;
 exports.ChainTypes = index$1.ChainTypes;
 exports.IPFSInfrastructureApi = explorer_utils.IPFSInfrastructureApi;
 exports.Web3ApplicationService = explorer_utils.Web3ApplicationService;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.js

@@ -1,19 +1,20 @@
-export { b as AUTH_STORAGE_KEYS, t as AnalyticsManager, z as ApiKeyApi, s as ApiKeyManager, j as AuthApi, n as AuthManager, k as AuthService, A as AuthStatus, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, f as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, l as DPoPManager, D as DefaultAuthProvider, u as DonationManager, x as FileApi, F as FileManager, y as FileService, I as IndexedDBTokenStorage, L as LocalStorageTokenStorage, M as MemoryTokenStorage, e as PersApiClient, P as PersSDK, q as PurchaseManager, R as RedemptionManager, r as TenantManager, T as TokenManager, p as TransactionManager, U as UserManager, o as UserStatusManager, v as Web3Manager, W as WebDPoPCryptoProvider, g as buildApiRoot, c as createPersSDK, h as detectEnvironment, i as environment, m as mergeWithDefaults, w as warnIfProblematicEnvironment } from './chunks/pers-sdk-Nu2KgiJf.js';
+export { b as AUTH_STORAGE_KEYS, x as AnalyticsManager, H as ApiKeyApi, v as ApiKeyManager, l as AuthApi, q as AuthManager, n as AuthService, A as AuthStatus, a as AuthTokenManager, B as BusinessManager, C as CampaignManager, h as DEFAULT_PERS_CONFIG, d as DPOP_STORAGE_KEYS, o as DPoPManager, D as DefaultAuthProvider, y as DonationManager, E as FileApi, F as FileManager, G as FileService, I as IndexedDBTokenStorage, L as LocalStorageTokenStorage, M as MemoryTokenStorage, g as PersApiClient, p as PersEventEmitter, P as PersSDK, t as PurchaseManager, R as RedemptionManager, S as SDK_NAME, f as SDK_USER_AGENT, e as SDK_VERSION, u as TenantManager, T as TokenManager, s as TransactionManager, U as UserManager, r as UserStatusManager, z as Web3Manager, W as WebDPoPCryptoProvider, i as buildApiRoot, c as createPersSDK, j as detectEnvironment, k as environment, m as mergeWithDefaults, w as warnIfProblematicEnvironment } from './chunks/pers-sdk-VmeBqUEP.js';
 export { a as CacheService, C as CacheTTL, g as globalCacheService } from './chunks/index-DBLskLuH.js';
-export { AccountOwnerType, ApiKeyType, NativeTokenTypes } from '@explorins/pers-shared';
-export { B as BusinessApi, a as BusinessService } from './chunks/business-service-8Xd3d5oY.js';
+export { b as ApiErrorDetector, A as AuthenticationError, E as ErrorUtils, L as LogoutRequired, M as MultipleContextSelectionRequiredError, N as NetworkError, a as PersApiError, P as ProviderTokenRefreshNeeded, T as TokenRefreshNeeded, W as Web3ChainApi, c as Web3ChainService } from './chunks/web3-chain-service-BcUeeujC.js';
+export { AccountOwnerType, ApiKeyType, MEMBERSHIP_ROLE_HIERARCHY, MembershipRole, NativeTokenTypes, hasMinimumRole } from '@explorins/pers-shared';
+export { BusinessApi, BusinessMembershipApi, BusinessMembershipService, BusinessService } from './business.js';
 export { T as TransactionApi, a as TransactionService } from './chunks/transaction-service-B7h_4Hg3.js';
+export { a as buildBurnRequest, b as buildMintRequest, e as buildPOSBurnRequest, d as buildPOSTransferRequest, f as buildSubmissionRequest, c as buildTransferRequest } from './chunks/transaction-request.builder-DltmruUC.js';
 export { A as AnalyticsApi, a as AnalyticsService } from './chunks/analytics-service-CxyrOwel.js';
-export { C as CampaignApi, a as CampaignService } from './chunks/campaign-service-CJPXgFBe.js';
+export { C as CampaignApi, a as CampaignService } from './chunks/campaign-service-CKwkiOLx.js';
 export { D as DonationApi, a as DonationService } from './chunks/donation-service-CyJS4DIZ.js';
 export { P as PaymentApi, a as PaymentService } from './chunks/payment-service-DfCBFosx.js';
 export { R as RedemptionApi, a as RedemptionService } from './chunks/redemption-service-BT0J5Iy7.js';
 export { T as TenantApi, a as TenantService } from './chunks/tenant-service-DxtHAlaa.js';
 export { B as BaseTokenService, T as TokenSDK } from './chunks/base-token-service-BSXDwrcq.js';
 export { T as TokenApi, a as TokenService } from './chunks/token-service-CpVwC5Eb.js';
-export { U as UserApi, a as UserService } from './chunks/user-service-D6mTa_WZ.js';
+export { U as UserApi, a as UserService } from './chunks/user-service-doT5vsBD.js';
 export { UserStatusApi, UserStatusService, createUserStatusSDK } from './user-status.js';
-export { W as Web3ChainApi, a as Web3ChainService } from './chunks/web3-chain-service-JRSwxr-s.js';
 export { C as ChainTypes } from './chunks/index-BtDNXaFq.js';
 export { I as IPFSInfrastructureApi, W as Web3ApplicationService, a as Web3InfrastructureApi, g as getExplorerUrl, b as getExplorerUrlByChainId } from './chunks/explorer.utils-BkS3k8hX.js';
 export { AngularHttpClientAdapter, BrowserFetchClientAdapter, NodeHttpClientAdapter } from './platform-adapters.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;"}

package/dist/managers/auth-manager.d.ts

@@ -1,12 +1,20 @@
 import { PersApiClient } from '../core/pers-api-client';
-import type { RawUserData } from '../core';
-import type { UserDTO, SessionAuthContextResponseDTO, SessionAuthResponseDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import { PersEventEmitter } from '../core/events';
+import type { AuthType, RawUserData } from '../core';
+import type { BusinessAuthOptions } from '../core/auth/api/auth-api';
+import type { UserDTO, SessionAuthContextResponseDTO, SessionAuthResponseDTO, BusinessDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+export type { BusinessAuthOptions } from '../core/auth/api/auth-api';
 /**
  * Authentication Manager - Clean, high-level interface for authentication operations
  *
  * Provides a simplified API for common authentication tasks while maintaining
  * access to the underlying API client for advanced use cases.
  *
+ * Supports the universal token endpoint (POST /auth/token):
+ * - User authentication (default)
+ * - Business authentication with role in JWT
+ * - Admin/Tenant authentication
+ *
  * @group Managers
  * @category Authentication
  *
@@ -15,6 +23,10 @@ import type { UserDTO, SessionAuthContextResponseDTO, SessionAuthResponseDTO } f
  * // Login with external JWT
  * const authResult = await sdk.auth.loginWithToken(firebaseJWT, 'user');
  *
+ * // Login as business (with role in JWT)
+ * const bizResult = await sdk.auth.loginAsBusiness(jwt, { businessId: 'biz-123' });
+ * console.log('Business:', bizResult.business?.displayName);
+ *
  * // Check authentication
  * if (await sdk.auth.isAuthenticated()) {
  *   const user = await sdk.auth.getCurrentUser();
@@ -27,7 +39,8 @@ import type { UserDTO, SessionAuthContextResponseDTO, SessionAuthResponseDTO } f
  */
 export declare class AuthManager {
     private apiClient;
-    constructor(apiClient: PersApiClient);
+    private events?;
+    constructor(apiClient: PersApiClient, events?: PersEventEmitter | undefined);
     /**
      * Login with JWT token
      *
@@ -50,7 +63,67 @@ export declare class AuthManager {
      * console.log('Admin authenticated:', authResult.admin.email);
      * ```
      */
-    loginWithToken(jwtToken: string, userType?: 'user' | 'admin'): Promise<SessionAuthContextResponseDTO>;
+    loginWithToken(jwtToken: string, userType?: AuthType): Promise<SessionAuthContextResponseDTO>;
+    /**
+     * Login as business with JWT token
+     *
+     * Authenticates a user in a business context. The returned JWT contains
+     * the user's role (OWNER, ADMIN, EDITOR, VIEWER) within that business.
+     *
+     * **Auto-Selection Behavior:**
+     * - If user has a single business membership, it's auto-selected
+     * - If user has multiple memberships and no businessId is provided,
+     *   throws `MULTIPLE_CONTEXT_SELECTION_REQUIRED` error with available options
+     *
+     * @param jwtToken - JWT token from auth provider (passkey, Firebase, etc.)
+     * @param options - Business authentication options
+     * @param options.businessId - The business ID to authenticate as (required for multi-business users)
+     * @returns Promise resolving to authentication response with business context and role in JWT
+     * @throws Error with code `MULTIPLE_CONTEXT_SELECTION_REQUIRED` when businessId is needed
+     *
+     * @example Single Business Membership
+     * ```typescript
+     * // Auto-selects the user's only business
+     * const result = await sdk.auth.loginAsBusiness(jwt);
+     * console.log('Business:', result.business?.displayName);
+     * ```
+     *
+     * @example Multiple Business Memberships
+     * ```typescript
+     * try {
+     *   const result = await sdk.auth.loginAsBusiness(jwt);
+     * } catch (error) {
+     *   if (error.code === 'MULTIPLE_CONTEXT_SELECTION_REQUIRED') {
+     *     // Show business selector UI
+     *     const selectedId = await showBusinessSelector(error.availableOptions);
+     *     const result = await sdk.auth.loginAsBusiness(jwt, { businessId: selectedId });
+     *   }
+     * }
+     * ```
+     *
+     * @example Direct Business Selection
+     * ```typescript
+     * const result = await sdk.auth.loginAsBusiness(jwt, { businessId: 'biz-123' });
+     * console.log('Authenticated as:', result.business?.displayName);
+     * ```
+     */
+    loginAsBusiness(jwtToken: string, options?: BusinessAuthOptions): Promise<SessionAuthContextResponseDTO>;
+    /**
+     * Get current business context
+     *
+     * Retrieves the current business context if authenticated as business.
+     * Requires prior business authentication via {@link loginAsBusiness}.
+     *
+     * @returns Promise resolving to current business data
+     * @throws {PersApiError} When not authenticated as business
+     *
+     * @example
+     * ```typescript
+     * const business = await sdk.auth.getCurrentBusiness();
+     * console.log('Current business:', business.displayName);
+     * ```
+     */
+    getCurrentBusiness(): Promise<BusinessDTO>;
     /**
      * Login with raw user data
      *

package/dist/managers/auth-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/managers/auth-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAEtI;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,OAAgB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAUnH;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAKxF;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IASzC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK3E;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;CAKvC"}
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/managers/auth-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAGnJ,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM,CAAC;gBADP,SAAS,EAAE,aAAa,EACxB,MAAM,CAAC,8BAAkB;IAGnC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAiB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAgB3G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAK9G;;;;;;;;;;;;;;OAcG;IACG,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC;IAIhD;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAKxF;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IASzC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK3E;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;CAKvC"}

package/dist/managers/business-manager.d.ts

@@ -1,6 +1,8 @@
 import { PersApiClient } from '../core/pers-api-client';
-import { BusinessService } from '../business';
-import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import { PersEventEmitter } from '../core/events';
+import { BusinessService, BusinessMembershipService } from '../business';
+import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessToggleActiveRequestDTO, BusinessMembershipDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import { MembershipRole } from '../shared/interfaces/pers-shared-lib.interfaces';
 /**
  * Business Manager - Clean, high-level interface for business operations
  *
@@ -58,9 +60,13 @@ import type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessTo
  */
 export declare class BusinessManager {
     private apiClient;
+    private events?;
     private businessApi;
     private businessService;
-    constructor(apiClient: PersApiClient);
+    private membershipApi;
+    private membershipService;
+    private userApi;
+    constructor(apiClient: PersApiClient, events?: PersEventEmitter | undefined);
     /**
      * Get all active businesses
      *
@@ -135,7 +141,7 @@ export declare class BusinessManager {
      *
      * // Use for transaction verification
      * if (business.isActive) {
-     *   console.log('✅ Verified business partner');
+     *   console.log('Verified business partner');
      * }
      * ```
      */
@@ -334,5 +340,187 @@ export declare class BusinessManager {
      * ```
      */
     getBusinessService(): BusinessService;
+    /**
+     * Get all members of a business
+     *
+     * Retrieves all users who have access to the specified business with their roles.
+     * Any member of the business can view the member list.
+     *
+     * @param businessId - The business UUID
+     * @returns Promise resolving to array of business memberships
+     * @throws {PersApiError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Not a member of this business
+     *
+     * @example
+     * ```typescript
+     * const members = await sdk.business.getMembers('business-123');
+     *
+     * console.log('Business Members:');
+     * members.forEach(member => {
+     *   console.log(`- User ${member.userId}: ${member.role}`);
+     * });
+     *
+     * // Count members by role
+     * const admins = members.filter(m => m.role === 'ADMIN' || m.role === 'OWNER');
+     * console.log(`Administrators: ${admins.length}`);
+     * ```
+     */
+    getMembers(businessId: string): Promise<BusinessMembershipDTO[]>;
+    /**
+     * Get members filtered by role
+     *
+     * @param businessId - The business UUID
+     * @param role - The role to filter by
+     * @returns Promise resolving to array of memberships with the specified role
+     *
+     * @example
+     * ```typescript
+     * const owners = await sdk.business.getMembersByRole('business-123', 'OWNER');
+     * console.log(`Business has ${owners.length} owner(s)`);
+     * ```
+     */
+    getMembersByRole(businessId: string, role: MembershipRole): Promise<BusinessMembershipDTO[]>;
+    /**
+     * Add a new member to a business
+     *
+     * Adds a user as a member of the business with the specified role.
+     * Requires ADMIN role or higher.
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to add
+     * @param role - The role to assign (defaults to VIEWER)
+     * @returns Promise resolving to the created membership
+     * @throws {PersApiError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Insufficient role (requires ADMIN)
+     * @throws {PersApiError} 404 - User not found
+     * @throws {PersApiError} 409 - User is already a member
+     *
+     * @example
+     * ```typescript
+     * // Add a new editor to the business
+     * const newMember = await sdk.business.addMember(
+     *   'business-123',
+     *   'user-456',
+     *   'EDITOR'
+     * );
+     *
+     * console.log(`Added ${newMember.userId} as ${newMember.role}`);
+     * ```
+     */
+    addMember(businessId: string, userId: string, role?: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Update a member's role
+     *
+     * Changes the role of an existing business member.
+     * Requires ADMIN role or higher. Cannot demote the last OWNER.
+     * Can only assign roles up to your own level (ADMIN cannot create OWNER).
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to update
+     * @param newRole - The new role to assign
+     * @returns Promise resolving to the updated membership
+     * @throws {PersApiError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Insufficient role (requires ADMIN)
+     * @throws {PersApiError} 404 - Membership not found
+     * @throws {PersApiError} 400 - Cannot demote last OWNER
+     *
+     * @example
+     * ```typescript
+     * // Promote an editor to admin
+     * const updated = await sdk.business.updateMemberRole(
+     *   'business-123',
+     *   'user-456',
+     *   'ADMIN'
+     * );
+     *
+     * console.log(`${updated.userId} is now ${updated.role}`);
+     * ```
+     */
+    updateMemberRole(businessId: string, userId: string, newRole: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Remove a member from a business
+     *
+     * Removes a user's access to the business.
+     * Requires ADMIN role or higher. Cannot remove the last OWNER.
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to remove
+     * @returns Promise resolving to success confirmation
+     * @throws {PersApiError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Insufficient role (requires ADMIN)
+     * @throws {PersApiError} 404 - Membership not found
+     * @throws {PersApiError} 400 - Cannot remove last OWNER
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.business.removeMember('business-123', 'user-456');
+     *
+     * if (result.success) {
+     *   console.log('Member removed successfully');
+     * }
+     * ```
+     */
+    removeMember(businessId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get permission flags for a role
+     *
+     * Returns an object with boolean flags indicating what actions
+     * a user with the given role can perform. Useful for UI rendering.
+     *
+     * @param role - The membership role (or null if not a member)
+     * @returns Object with permission flags
+     *
+     * @example
+     * ```typescript
+     * const permissions = sdk.business.getPermissions('EDITOR');
+     * // { canViewMembers: true, canManageMembers: false, canEditContent: true, canDeleteBusiness: false }
+     *
+     * if (permissions.canManageMembers) {
+     *   showAddMemberButton();
+     * }
+     * ```
+     */
+    getPermissions(role: MembershipRole | null): {
+        canViewMembers: boolean;
+        canManageMembers: boolean;
+        canEditContent: boolean;
+        canDeleteBusiness: boolean;
+    };
+    /**
+     * Add a member to a business by email address
+     *
+     * Convenience method that creates or retrieves a user by email and adds them
+     * as a member of the business. If the user doesn't exist, they will be created.
+     * Requires ADMIN role or higher.
+     *
+     * @param businessId - The business UUID
+     * @param email - The email address of the user to add
+     * @param role - The role to assign (defaults to VIEWER)
+     * @returns Promise resolving to the created membership
+     * @throws {PersApiError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Insufficient role (requires ADMIN)
+     * @throws {PersApiError} 409 - User is already a member
+     *
+     * @example
+     * ```typescript
+     * // Add a new editor by email - user is created if they don't exist
+     * const membership = await sdk.business.addMemberByEmail(
+     *   'business-123',
+     *   'newuser@example.com',
+     *   'EDITOR'
+     * );
+     *
+     * console.log(`Added user ${membership.userId} as ${membership.role}`);
+     * ```
+     */
+    addMemberByEmail(businessId: string, email: string, role?: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Get the membership service for advanced operations
+     *
+     * @returns BusinessMembershipService instance
+     */
+    getMembershipService(): BusinessMembershipService;
 }
 //# sourceMappingURL=business-manager.d.ts.map

package/dist/managers/business-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"business-manager.d.ts","sourceRoot":"","sources":["../../src/managers/business-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,iDAAiD,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAkB;gBAErB,SAAS,EAAE,aAAa;IAK5C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAInD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/D;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAItG;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,8BAA8B,GAAG,OAAO,CAAC,WAAW,CAAC;IAIhH;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,kBAAkB;CAInB"}
+{"version":3,"file":"business-manager.d.ts","sourceRoot":"","sources":["../../src/managers/business-manager.ts"],"names":[],"mappings":"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"}

package/dist/managers/campaign-manager.d.ts

@@ -1,4 +1,6 @@
+import { PaginatedResponseDTO } from '@explorins/pers-shared';
 import { PersApiClient } from '../core/pers-api-client';
+import { PersEventEmitter } from '../core/events';
 import { CampaignService } from '../campaign';
 import type { CampaignDTO, CampaignCreateRequestDTO, CampaignClaimRequestDTO, CampaignClaimDTO, TokenUnitCreateRequestDTO, CampaignBusinessEngagementCreateRequestDTO, CampaignTriggerDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
 /**
@@ -14,9 +16,9 @@ import type { CampaignDTO, CampaignCreateRequestDTO, CampaignClaimRequestDTO, Ca
  *
  * @example Basic Campaign Operations
  * ```typescript
- * // Get all available campaigns for users
- * const campaigns = await sdk.campaigns.getActiveCampaigns();
- * console.log(`${campaigns.length} active campaigns available`);
+ * // Get all available campaigns (paginated)
+ * const result = await sdk.campaigns.getCampaigns({ page: 1, limit: 20 });
+ * console.log(`${result.data.length} of ${result.total} campaigns`);
  *
  * // Get specific campaign details
  * const campaign = await sdk.campaigns.getCampaignById('summer-promo-2024');
@@ -42,7 +44,8 @@ import type { CampaignDTO, CampaignCreateRequestDTO, CampaignClaimRequestDTO, Ca
  * });
  *
  * // Check if user can claim specific campaign
- * const eligibleCampaigns = campaigns.filter(c =>
+ * const campaigns = await sdk.campaigns.getCampaigns({ active: true });
+ * const eligibleCampaigns = campaigns.data.filter(c =>
  *   !userClaims.some(claim => claim.campaignId === c.id)
  * );
  * ```
@@ -68,42 +71,9 @@ import type { CampaignDTO, CampaignCreateRequestDTO, CampaignClaimRequestDTO, Ca
  */
 export declare class CampaignManager {
     private apiClient;
+    private events?;
     private campaignService;
-    constructor(apiClient: PersApiClient);
-    /**
-     * Get all active campaigns
-     *
-     * Retrieves all currently active campaigns that users can discover and claim.
-     * Active campaigns are live promotional offers with valid date ranges and
-     * available rewards. Includes campaign details, eligibility requirements, and reward information.
-     *
-     * @returns Promise resolving to array of active campaign data
-     *
-     * @example
-     * ```typescript
-     * const activeCampaigns = await sdk.campaigns.getActiveCampaigns();
-     *
-     * console.log('Available Campaigns:');
-     * activeCampaigns.forEach(campaign => {
-     *   console.log(`\n📢 ${campaign.title}`);
-     *   console.log(`   ${campaign.description}`);
-     *   console.log(`   Valid: ${campaign.startDate} to ${campaign.endDate}`);
-     *   console.log(`   Rewards: ${campaign.tokenUnits?.length || 0} types`);
-     *
-     *   if (campaign.businessEngagements?.length) {
-     *     console.log(`   Partner businesses: ${campaign.businessEngagements.length}`);
-     *   }
-     * });
-     *
-     * // Filter campaigns by type or business
-     * const hotelCampaigns = activeCampaigns.filter(c =>
-     *   c.businessEngagements?.some(be =>
-     *     be.business?.businessType?.name?.includes('Hotel')
-     *   )
-     * );
-     * ```
-     */
-    getActiveCampaigns(): Promise<CampaignDTO[]>;
+    constructor(apiClient: PersApiClient, events?: PersEventEmitter | undefined);
     /**
      * Get campaign by ID
      *
@@ -237,39 +207,52 @@ export declare class CampaignManager {
      */
     getUserClaims(): Promise<CampaignClaimDTO[]>;
     /**
-     * Admin: Get all campaigns
+     * Get campaigns with pagination support
      *
-     * Retrieves all campaigns in the system regardless of status. This operation
-     * requires administrator privileges and is used for comprehensive campaign
-     * management, reporting, and lifecycle operations.
+     * Returns campaigns with pagination metadata for efficient data loading.
+     * Intelligent access: Public gets active only, Business gets own campaigns, Admin gets all.
      *
-     * @param active - Optional filter to show only active or inactive campaigns
-     * @returns Promise resolving to array of campaigns
-     * @throws {PersApiError} When not authenticated as administrator
+     * @param options - Pagination and filter options
+     * @param options.active - Filter by active status (true/false/undefined for all)
+     * @param options.businessId - Filter by business engagement
+     * @param options.page - Page number (1-based, default: 1)
+     * @param options.limit - Items per page (default: 50)
+     * @param options.sortBy - Sort field ('name', 'createdAt', 'startDate')
+     * @param options.sortOrder - Sort direction ('ASC' or 'DESC')
+     * @returns Promise resolving to paginated campaigns with metadata
      *
      * @example
      * ```typescript
-     * // Admin operation - get campaign overview
-     * const allCampaigns = await sdk.campaigns.getAllCampaigns();
-     * const activeCampaigns = await sdk.campaigns.getAllCampaigns(true);
-     * const inactiveCampaigns = await sdk.campaigns.getAllCampaigns(false);
-     *
-     * console.log('📊 Campaign Statistics:');
-     * console.log(`Total campaigns: ${allCampaigns.length}`);
-     * console.log(`Active campaigns: ${activeCampaigns.length}`);
-     * console.log(`Inactive campaigns: ${inactiveCampaigns.length}`);
-     *
-     * // Generate campaign performance report
-     * const campaignReport = allCampaigns.map(campaign => ({
-     *   title: campaign.title,
-     *   status: campaign.isActive ? 'Active' : 'Inactive',
-     *   period: `${campaign.startDate} to ${campaign.endDate}`,
-     *   businesses: campaign.businessEngagements?.length || 0,
-     *   rewardTypes: campaign.tokenUnits?.length || 0
-     * }));
+     * // Get first page of campaigns
+     * const result = await sdk.campaigns.getCampaigns({ page: 1, limit: 10 });
+     * console.log(`Showing ${result.data.length} of ${result.total} campaigns`);
+     * console.log(`Has more pages: ${result.hasMore}`);
+     *
+     * // Get campaigns for a specific business
+     * const businessCampaigns = await sdk.campaigns.getCampaigns({
+     *   businessId: 'business-123',
+     *   page: 1,
+     *   limit: 20
+     * });
+     *
+     * // Get active campaigns sorted by creation date
+     * const activeCampaigns = await sdk.campaigns.getCampaigns({
+     *   active: true,
+     *   sortBy: 'createdAt',
+     *   sortOrder: 'DESC',
+     *   page: 1,
+     *   limit: 25
+     * });
      * ```
      */
-    getAllCampaigns(active?: boolean): Promise<CampaignDTO[]>;
+    getCampaigns(options?: {
+        active?: boolean;
+        businessId?: string;
+        page?: number;
+        limit?: number;
+        sortBy?: 'name' | 'createdAt' | 'startDate';
+        sortOrder?: 'ASC' | 'DESC';
+    }): Promise<PaginatedResponseDTO<CampaignDTO>>;
     /**
      * Admin: Create new campaign
      *