@explorins/pers-sdk 1.6.45 → 1.6.47

package/README.md

@@ -16,6 +16,14 @@ Platform-agnostic TypeScript SDK for PERS (Phygital Experience Rewards System) -
 - [Platform Integration](#platform-integration)
 - [Architecture](#architecture)
 - [Core Features](#core-features)
+  - [Event System](#event-system)
+  - [Authentication](#authentication)
+  - [Business Management](#business-management)
+  - [Campaign System](#campaign-system)
+  - [Token Management](#token-management)
+  - [User Token Balances](#user-token-balances-on-chain)
+  - [Transaction Request Building](#transaction-request-building)
+  - [Purchase/Payment Processing](#purchasepayment-processing)
 - [Configuration](#configuration)
 - [Advanced Authentication](#advanced-authentication)
 - [Error Handling](#error-handling)
@@ -332,6 +340,85 @@ await apiClient.post('/custom-endpoint', { data: 'value' });
 
 ## Core Features
 
+### Event System
+
+The SDK provides a platform-agnostic event system for subscribing to SDK-wide events. All events have a `userMessage` field ready for UI display.
+
+```typescript
+// Subscribe to ALL events - one handler
+const unsubscribe = sdk.events.subscribe((event) => {
+  showNotification(event.userMessage, event.level);
+});
+
+// Filter by domain and level
+sdk.events.subscribe((event) => {
+  logToSentry(event);
+}, { level: 'error' });
+
+// Only transaction successes
+sdk.events.subscribe((event) => {
+  playSuccessSound();
+  confetti();
+}, { domain: 'transaction', level: 'success' });
+
+// One-time event (auto-unsubscribe)
+sdk.events.once((event) => {
+  console.log('First event:', event.type);
+});
+
+// Cleanup
+unsubscribe();
+```
+
+#### Event Domains
+
+| Domain | Manager | Events |
+|--------|---------|--------|
+| `authentication` | `sdk.auth` | `LOGIN_SUCCESS` |
+| `user` | `sdk.users` | `PROFILE_UPDATED` |
+| `business` | `sdk.businesses` | `BUSINESS_CREATED`, `BUSINESS_UPDATED`, `MEMBERSHIP_UPDATED` |
+| `campaign` | `sdk.campaigns` | `CAMPAIGN_CLAIMED` |
+| `redemption` | `sdk.redemptions` | `REDEMPTION_COMPLETED` |
+| `transaction` | `sdk.transactions` | `TRANSACTION_CREATED`, `TRANSACTION_SUBMITTED` |
+
+#### Event Types
+
+```typescript
+import type { 
+  PersEvent,      // Base event type (discriminated union)
+  SuccessEvent,   // Success events (business domains)
+  ErrorEvent,     // Error events (all domains including technical)
+  EventFilter,    // Filter for subscriptions
+  EventHandler    // Handler type (sync or async)
+} from '@explorins/pers-sdk/core';
+
+// Event structure
+interface PersEvent {
+  id: string;           // Unique event ID
+  timestamp: number;    // Unix timestamp (ms)
+  domain: string;       // Event domain
+  type: string;         // Event type within domain
+  level: 'success' | 'error';
+  userMessage: string;  // Ready for UI display
+  action?: string;      // Suggested action
+  code?: string;        // Backend error code
+  details?: object;     // Additional data for logging
+}
+```
+
+#### Async Handler Support
+
+Event handlers can be synchronous or asynchronous. Async errors are caught automatically:
+
+```typescript
+sdk.events.subscribe(async (event) => {
+  await saveToDatabase(event);  // Async operations supported
+  await sendAnalytics(event);
+});
+```
+
+---
+
 ### Authentication
 
 The SDK uses **external JWT tokens** for authentication. You provide a JWT from your authentication provider (Firebase, Auth0, Cognito, etc.), and the SDK exchanges it for PERS access tokens.
@@ -538,6 +625,104 @@ async function loadUserTokenBalances(sdk: PersSDK) {
 }
 ```
 
+### Transaction Request Building
+
+The SDK provides factory functions for building transaction request DTOs. These are tree-shakeable and provide type-safe transaction creation:
+
+```typescript
+import { 
+  buildMintRequest, 
+  buildBurnRequest, 
+  buildTransferRequest,
+  buildPOSTransferRequest,
+  buildSubmissionRequest 
+} from '@explorins/pers-sdk/transaction';
+import { AccountOwnerType } from '@explorins/pers-shared';
+
+// Mint tokens to a recipient
+const mintRequest = buildMintRequest({
+  amount: 100,
+  contractAddress: '0x...',
+  chainId: 137,
+  recipientAccountId: 'user-123',
+  recipientAccountType: AccountOwnerType.USER
+});
+
+// Burn tokens
+const burnRequest = buildBurnRequest({
+  amount: 50,
+  contractAddress: '0x...',
+  chainId: 137,
+  senderAccountId: 'user-123',
+  senderAccountType: AccountOwnerType.USER
+});
+
+// Transfer tokens between accounts
+const transferRequest = buildTransferRequest({
+  amount: 100,
+  contractAddress: '0x...',
+  chainId: 137,
+  senderAccountId: 'user-123',
+  senderAccountType: AccountOwnerType.USER,
+  recipientAccountId: 'business-456',
+  recipientAccountType: AccountOwnerType.BUSINESS
+});
+
+// Submit the transaction
+const result = await sdk.transactions.createTransaction(mintRequest);
+```
+
+#### POS Transaction Flow
+
+For Point-of-Sale scenarios where a **business submits a transaction on behalf of a user**, use `buildPOSTransferRequest`:
+
+```typescript
+import { buildPOSTransferRequest } from '@explorins/pers-sdk/transaction';
+
+// POS flow: User pays business, business authorized to submit
+const posRequest = buildPOSTransferRequest({
+  amount: 100,
+  contractAddress: '0x...',
+  chainId: 137,
+  userAccountId: 'user-123',      // User sending tokens
+  businessAccountId: 'business-456' // Business receiving & authorized to submit
+});
+
+// This automatically sets:
+// - engagedBusinessId: 'business-456' (for reporting)
+// - authorizedSubmitterId: 'business-456' (can submit the signed tx)
+// - authorizedSubmitterType: AccountOwnerType.BUSINESS
+
+const result = await sdk.transactions.createTransaction(posRequest);
+```
+
+For custom authorization scenarios, use `buildTransferRequest` with manual POS fields:
+
+```typescript
+import { buildTransferRequest, type POSAuthorizationOptions } from '@explorins/pers-sdk/transaction';
+
+const customPOSRequest = buildTransferRequest({
+  amount: 100,
+  contractAddress: '0x...',
+  chainId: 137,
+  senderAccountId: 'user-123',
+  senderAccountType: AccountOwnerType.USER,
+  recipientAccountId: 'business-456',
+  recipientAccountType: AccountOwnerType.BUSINESS,
+  // POS authorization fields
+  engagedBusinessId: 'business-456',
+  authorizedSubmitterId: 'business-456',
+  authorizedSubmitterType: AccountOwnerType.BUSINESS
+});
+```
+
+| POS Field | Type | Description |
+|-----------|------|-------------|
+| `engagedBusinessId` | `string` | Business commercially involved (for stats/reporting) |
+| `authorizedSubmitterId` | `string` | Entity authorized to submit the signed transaction |
+| `authorizedSubmitterType` | `AccountOwnerType` | Type of authorized submitter (`USER` or `BUSINESS`) |
+```
+
 ### Purchase/Payment Processing
 
 ```typescript

package/dist/analytics.cjs

@@ -15,8 +15,20 @@ 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; }
 });
+Object.defineProperty(exports, "hasMinimumRole", {
+	enumerable: true,
+	get: function () { return persShared.hasMinimumRole; }
+});
 //# sourceMappingURL=analytics.cjs.map

package/dist/analytics.cjs.map

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

package/dist/analytics.js

@@ -1,3 +1,3 @@
 export { A as AnalyticsApi, a as AnalyticsService } from './chunks/analytics-service-CxyrOwel.js';
-export { AccountOwnerType, ApiKeyType, NativeTokenTypes } from '@explorins/pers-shared';
+export { AccountOwnerType, ApiKeyType, MEMBERSHIP_ROLE_HIERARCHY, MembershipRole, NativeTokenTypes, hasMinimumRole } from '@explorins/pers-shared';
 //# sourceMappingURL=analytics.js.map

package/dist/business/api/business-membership-api.d.ts

@@ -0,0 +1,186 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import { BusinessMembershipDTO, AddBusinessMemberRequestDTO, UpdateBusinessMembershipRequestDTO, MembershipRole } from '../../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * Business Membership API Client
+ *
+ * Platform-agnostic API client for managing business memberships.
+ * Handles user access to businesses with role-based permissions.
+ *
+ * Base Path: /businesses/:businessId/members
+ *
+ * Required Headers:
+ * - Authorization: Bearer <business_jwt_token>
+ * - X-Project-Key: <project_key>
+ *
+ * @example
+ * ```typescript
+ * const membershipApi = new BusinessMembershipApi(apiClient);
+ *
+ * // List all members of a business
+ * const members = await membershipApi.getMembers('business-123');
+ *
+ * // Add a new member
+ * const newMember = await membershipApi.addMember('business-123', {
+ *   userId: 'user-456',
+ *   role: MembershipRole.EDITOR
+ * });
+ * ```
+ *
+ * @version 2.0.0
+ */
+export declare class BusinessMembershipApi {
+    private apiClient;
+    constructor(apiClient: PersApiClient);
+    /**
+     * Build the membership endpoint path for a business
+     */
+    private getMembersPath;
+    /**
+     * Build the membership endpoint path for a specific member
+     */
+    private getMemberPath;
+    /**
+     * List all members of a business
+     *
+     * Endpoint: GET /businesses/:businessId/members
+     * Min Role: VIEWER (any member can view)
+     *
+     * @param businessId - The business UUID
+     * @returns Array of business memberships with user and role details
+     *
+     * @throws {AuthenticationError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - businessId in path doesn't match JWT's business
+     *
+     * @example
+     * ```typescript
+     * const members = await membershipApi.getMembers('business-123');
+     * members.forEach(m => console.log(`${m.userId}: ${m.role}`));
+     * ```
+     */
+    getMembers(businessId: string): Promise<BusinessMembershipDTO[]>;
+    /**
+     * Add a member to a business
+     *
+     * Endpoint: POST /businesses/:businessId/members
+     * Min Role: ADMIN
+     *
+     * @param businessId - The business UUID
+     * @param request - The add member request with userId and optional role
+     * @returns The created business membership
+     *
+     * @throws {AuthenticationError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Insufficient role (requires ADMIN or higher)
+     * @throws {PersApiError} 404 - User not found
+     * @throws {PersApiError} 409 - User is already a member
+     *
+     * @example
+     * ```typescript
+     * const newMember = await membershipApi.addMember('business-123', {
+     *   userId: 'user-456',
+     *   role: MembershipRole.EDITOR
+     * });
+     * ```
+     */
+    addMember(businessId: string, request: AddBusinessMemberRequestDTO): Promise<BusinessMembershipDTO>;
+    /**
+     * Add a member to a business with explicit parameters
+     *
+     * Convenience method that constructs the request DTO internally.
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to add
+     * @param role - The role to assign (defaults to VIEWER)
+     * @returns The created business membership
+     *
+     * @example
+     * ```typescript
+     * const member = await membershipApi.addMemberByUserId(
+     *   'business-123',
+     *   'user-456',
+     *   MembershipRole.EDITOR
+     * );
+     * ```
+     */
+    addMemberByUserId(businessId: string, userId: string, role?: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Update a member's role in a business
+     *
+     * Endpoint: PUT /businesses/:businessId/members/:userId
+     * Min Role: ADMIN
+     *
+     * Business Rules:
+     * - Cannot demote the last OWNER (must transfer ownership first)
+     * - 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 request - The update request with new role
+     * @returns The updated business membership
+     *
+     * @throws {AuthenticationError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Insufficient role (requires ADMIN or higher)
+     * @throws {PersApiError} 404 - Membership not found
+     * @throws {PersApiError} 400 - Cannot demote last OWNER
+     *
+     * @example
+     * ```typescript
+     * const updated = await membershipApi.updateMemberRole(
+     *   'business-123',
+     *   'user-456',
+     *   { role: MembershipRole.ADMIN }
+     * );
+     * ```
+     */
+    updateMemberRole(businessId: string, userId: string, request: UpdateBusinessMembershipRequestDTO): Promise<BusinessMembershipDTO>;
+    /**
+     * Update a member's role with explicit parameters
+     *
+     * Convenience method that constructs the request DTO internally.
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to update
+     * @param role - The new role to assign
+     * @returns The updated business membership
+     *
+     * @example
+     * ```typescript
+     * const updated = await membershipApi.setMemberRole(
+     *   'business-123',
+     *   'user-456',
+     *   MembershipRole.ADMIN
+     * );
+     * ```
+     */
+    setMemberRole(businessId: string, userId: string, role: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Remove a member from a business
+     *
+     * Endpoint: DELETE /businesses/:businessId/members/:userId
+     * Min Role: ADMIN
+     *
+     * Business Rules:
+     * - Cannot remove the last OWNER
+     * - Cannot remove yourself (use leave endpoint or transfer ownership)
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to remove
+     * @returns Success confirmation
+     *
+     * @throws {AuthenticationError} 401 - Not authenticated
+     * @throws {PersApiError} 403 - Insufficient role (requires ADMIN or higher)
+     * @throws {PersApiError} 404 - Membership not found
+     * @throws {PersApiError} 400 - Cannot remove last OWNER
+     *
+     * @example
+     * ```typescript
+     * const result = await membershipApi.removeMember('business-123', 'user-456');
+     * if (result.success) {
+     *   console.log('Member removed successfully');
+     * }
+     * ```
+     */
+    removeMember(businessId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=business-membership-api.d.ts.map

package/dist/business/api/business-membership-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-membership-api.d.ts","sourceRoot":"","sources":["../../../src/business/api/business-membership-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,kCAAkC,EAClC,cAAc,EACf,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;;;;;;;;;;;;;;;;OAiBG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAUtE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC;IAOjC;;;;;;;;;;;;;;;;;;OAkBG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,cAAsC,GAC3C,OAAO,CAAC,qBAAqB,CAAC;IAQjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,qBAAqB,CAAC;IAOjC;;;;;;;;;;;;;;;;;;OAkBG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,qBAAqB,CAAC;IAQjC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAKjC"}

package/dist/business/index.d.ts

@@ -5,6 +5,8 @@
  * Focuses on non-admin business operations
  */
 export { BusinessApi } from './api/business-api';
+export { BusinessMembershipApi } from './api/business-membership-api';
 export { BusinessService } from './services/business-service';
+export { BusinessMembershipService } from './services/business-membership-service';
 export * from '../shared/interfaces/pers-shared-lib.interfaces';
 //# sourceMappingURL=index.d.ts.map

package/dist/business/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/business/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,cAAc,iDAAiD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/business/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAGnF,cAAc,iDAAiD,CAAC"}

package/dist/business/services/business-membership-service.d.ts

@@ -0,0 +1,186 @@
+import { BusinessMembershipApi } from '../api/business-membership-api';
+import { BusinessMembershipDTO, MembershipRole } from '../../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * Business Membership Service
+ *
+ * Platform-agnostic service for managing business memberships.
+ * Provides business logic layer on top of the API client with
+ * convenience methods and role-based utilities.
+ *
+ * @example
+ * ```typescript
+ * const service = new BusinessMembershipService(membershipApi);
+ *
+ * // Get members with admin permissions
+ * const admins = await service.getMembersByRole('business-123', MembershipRole.ADMIN);
+ *
+ * // Check permissions
+ * const canManage = service.canManageMembers(MembershipRole.ADMIN); // true
+ * ```
+ *
+ * @version 2.0.0
+ */
+export declare class BusinessMembershipService {
+    private membershipApi;
+    constructor(membershipApi: BusinessMembershipApi);
+    /**
+     * Get all members of a business
+     *
+     * @param businessId - The business UUID
+     * @returns Array of business memberships
+     */
+    getMembers(businessId: string): Promise<BusinessMembershipDTO[]>;
+    /**
+     * Get members filtered by role
+     *
+     * @param businessId - The business UUID
+     * @param role - The role to filter by
+     * @returns Array of memberships with the specified role
+     *
+     * @example
+     * ```typescript
+     * const owners = await service.getMembersByRole('biz-123', MembershipRole.OWNER);
+     * const adminsAndAbove = await service.getMembersWithMinRole('biz-123', MembershipRole.ADMIN);
+     * ```
+     */
+    getMembersByRole(businessId: string, role: MembershipRole): Promise<BusinessMembershipDTO[]>;
+    /**
+     * Get members with at least a minimum role level
+     *
+     * Uses the role hierarchy: OWNER > ADMIN > EDITOR > VIEWER
+     *
+     * @param businessId - The business UUID
+     * @param minRole - The minimum role level
+     * @returns Array of memberships with role >= minRole
+     *
+     * @example
+     * ```typescript
+     * // Get all members who can manage content (EDITOR and above)
+     * const editors = await service.getMembersWithMinRole('biz-123', MembershipRole.EDITOR);
+     * ```
+     */
+    getMembersWithMinRole(businessId: string, minRole: MembershipRole): Promise<BusinessMembershipDTO[]>;
+    /**
+     * Get a specific member by user ID
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to find
+     * @returns The membership if found, undefined otherwise
+     */
+    getMemberByUserId(businessId: string, userId: string): Promise<BusinessMembershipDTO | undefined>;
+    /**
+     * Count members by role
+     *
+     * @param businessId - The business UUID
+     * @returns Object with count per role
+     *
+     * @example
+     * ```typescript
+     * const counts = await service.getMemberCountsByRole('biz-123');
+     * // { OWNER: 1, ADMIN: 2, EDITOR: 5, VIEWER: 10 }
+     * ```
+     */
+    getMemberCountsByRole(businessId: string): Promise<Record<MembershipRole, number>>;
+    /**
+     * Add a new member to a business
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to add
+     * @param role - The role to assign (defaults to VIEWER)
+     * @returns The created membership
+     */
+    addMember(businessId: string, userId: string, role?: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Update a member's role
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to update
+     * @param newRole - The new role to assign
+     * @returns The updated membership
+     */
+    updateMemberRole(businessId: string, userId: string, newRole: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Remove a member from a business
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to remove
+     * @returns Success confirmation
+     */
+    removeMember(businessId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Promote a member to a higher role
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to promote
+     * @param targetRole - The target role (must be higher than current)
+     * @returns The updated membership
+     * @throws Error if target role is not higher than current
+     */
+    promoteMember(businessId: string, userId: string, targetRole: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Demote a member to a lower role
+     *
+     * Note: Cannot demote the last OWNER
+     *
+     * @param businessId - The business UUID
+     * @param userId - The user UUID to demote
+     * @param targetRole - The target role (must be lower than current)
+     * @returns The updated membership
+     * @throws Error if target role is not lower than current
+     */
+    demoteMember(businessId: string, userId: string, targetRole: MembershipRole): Promise<BusinessMembershipDTO>;
+    /**
+     * Check if a role can view members (any member)
+     */
+    canViewMembers(role: MembershipRole | null): boolean;
+    /**
+     * Check if a role can manage members (ADMIN or higher)
+     */
+    canManageMembers(role: MembershipRole | null): boolean;
+    /**
+     * Check if a role can edit content (EDITOR or higher)
+     */
+    canEditContent(role: MembershipRole | null): boolean;
+    /**
+     * Check if a role can delete the business (OWNER only)
+     */
+    canDeleteBusiness(role: MembershipRole | null): boolean;
+    /**
+     * Get permissions object for a role
+     *
+     * Useful for UI components to conditionally render based on permissions.
+     *
+     * @param role - The membership role (or null if not a member)
+     * @returns Object with boolean permission flags
+     *
+     * @example
+     * ```typescript
+     * const perms = service.getPermissions(MembershipRole.EDITOR);
+     * // { canViewMembers: true, canManageMembers: false, canEditContent: true, canDeleteBusiness: false }
+     *
+     * if (perms.canManageMembers) {
+     *   showAddMemberButton();
+     * }
+     * ```
+     */
+    getPermissions(role: MembershipRole | null): {
+        canViewMembers: boolean;
+        canManageMembers: boolean;
+        canEditContent: boolean;
+        canDeleteBusiness: boolean;
+    };
+    /**
+     * Check if a role can assign another role
+     *
+     * Rule: Can only assign roles up to your own level
+     * (ADMIN cannot create OWNER, but OWNER can create anything)
+     *
+     * @param assignerRole - The role of the user assigning
+     * @param targetRole - The role being assigned
+     * @returns true if the assigner can assign the target role
+     */
+    canAssignRole(assignerRole: MembershipRole, targetRole: MembershipRole): boolean;
+}
+//# sourceMappingURL=business-membership-service.d.ts.map

package/dist/business/services/business-membership-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-membership-service.d.ts","sourceRoot":"","sources":["../../../src/business/services/business-membership-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,cAAc,EAEf,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAAyB;IACxB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,qBAAqB;IAMxD;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAItE;;;;;;;;;;;;OAYG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAKnC;;;;;;;;;;;;;;OAcG;IACG,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAKnC;;;;;;OAMG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAK7C;;;;;;;;;;;OAWG;IACG,qBAAqB,CACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAuB1C;;;;;;;OAOG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,cAAsC,GAC3C,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;;;;;;OAOG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;;;;;OAMG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAIhC;;;;;;;;OAQG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,qBAAqB,CAAC;IAejC;;;;;;;;;;OAUG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,qBAAqB,CAAC;IAmBjC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO;IAIpD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO;IAItD;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO;IAIpD;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO;IAIvD;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG;QAC3C,cAAc,EAAE,OAAO,CAAC;QACxB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,cAAc,EAAE,OAAO,CAAC;QACxB,iBAAiB,EAAE,OAAO,CAAC;KAC5B;IASD;;;;;;;;;OASG;IACH,aAAa,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,GAAG,OAAO;CASjF"}