@explorins/pers-sdk 2.1.6 → 2.1.7

package/dist/analytics/api/analytics-api.d.ts

@@ -1,5 +1,5 @@
 import { PersApiClient } from '../../core/pers-api-client';
-import { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO } from '../models';
+import { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO, TagAnalyticsRequestDTO, TagAnalyticsResponseDTO } from '../models';
 /**
  * Platform-Agnostic Analytics API Client
  *
@@ -187,5 +187,45 @@ export declare class AnalyticsApi {
      * ```
      */
     getRetentionAnalytics(request?: RetentionAnalyticsRequestDTO): Promise<RetentionAnalyticsResponseDTO>;
+    /**
+     * ADMIN: Get tag usage analytics across entities
+     *
+     * Aggregates tag usage across all taggable entities (campaigns, redemptions,
+     * businesses, token metadata, user status types). Perfect for:
+     * - Tag autocomplete/suggestions
+     * - Tag management dashboards
+     * - Usage analytics
+     *
+     * @param request - Optional filters for entity types
+     * @returns Aggregated tag usage with per-entity-type breakdown
+     *
+     * @example Get all tags across all entities
+     * ```typescript
+     * const allTags = await analyticsApi.getTagAnalytics();
+     * console.log(`${allTags.totalTags} unique tags, ${allTags.totalUsage} total usages`);
+     *
+     * // Use for autocomplete suggestions
+     * const suggestions = allTags.tags.map(t => t.tag);
+     * ```
+     *
+     * @example Get tags only from campaigns and businesses
+     * ```typescript
+     * const filteredTags = await analyticsApi.getTagAnalytics({
+     *   entityTypes: [TaggableEntityType.CAMPAIGN, TaggableEntityType.BUSINESS]
+     * });
+     * ```
+     *
+     * @example Tag usage breakdown
+     * ```typescript
+     * const analytics = await analyticsApi.getTagAnalytics();
+     * analytics.tags.forEach(({ tag, count, usageByEntityType }) => {
+     *   console.log(`${tag}: ${count} total`);
+     *   usageByEntityType.forEach(({ entityType, count }) => {
+     *     console.log(`  - ${entityType}: ${count}`);
+     *   });
+     * });
+     * ```
+     */
+    getTagAnalytics(request?: TagAnalyticsRequestDTO): Promise<TagAnalyticsResponseDTO>;
 }
 //# sourceMappingURL=analytics-api.d.ts.map

package/dist/analytics/api/analytics-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics-api.d.ts","sourceRoot":"","sources":["../../../src/analytics/api/analytics-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,WAAW,CAAC;AAGnB;;;;;GAKG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAM5C;;OAEG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAIhH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,iCAAiC,CAAC;IAItH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACG,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,cAAc,CAAC,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAI5G;;;;;;;;;;;;;;;;;OAiBG;IACG,kBAAkB,CAAC,OAAO,GAAE,kCAAuC,GAAG,OAAO,CAAC,mCAAmC,CAAC;IAIxH;;;;;;;;;;;;;;;OAeG;IACG,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAGhH"}
+{"version":3,"file":"analytics-api.d.ts","sourceRoot":"","sources":["../../../src/analytics/api/analytics-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EAExB,MAAM,WAAW,CAAC;AAGnB;;;;;GAKG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAM5C;;OAEG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAIhH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,iCAAiC,CAAC;IAItH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACG,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,cAAc,CAAC,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAI5G;;;;;;;;;;;;;;;;;OAiBG;IACG,kBAAkB,CAAC,OAAO,GAAE,kCAAuC,GAAG,OAAO,CAAC,mCAAmC,CAAC;IAIxH;;;;;;;;;;;;;;;OAeG;IACG,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAQ/G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACG,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAS9F"}

package/dist/analytics/models/index.d.ts

@@ -4,6 +4,6 @@
  * Re-exports from @explorins/pers-shared for consistency with backend
  * and to provide a single import source for analytics-related types.
  */
-import { AnalyticsGroupByType, AnalyticsMetricType, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionAnalyticsResultItem, GroupByExpressionDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, CampaignClaimAnalyticsFiltersDTO, SortOrder, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserAnalyticsFiltersDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, UserRankingResultItemDTO, UserRankingFiltersDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, BusinessRankingResultItemDTO, BusinessRankingFiltersDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO, RetentionMonthResultDTO } from '@explorins/pers-shared';
-export { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionAnalyticsResultItem, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, CampaignClaimAnalyticsFiltersDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserAnalyticsFiltersDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, UserRankingResultItemDTO, UserRankingFiltersDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, BusinessRankingResultItemDTO, BusinessRankingFiltersDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO, RetentionMonthResultDTO, GroupByExpressionDTO, AnalyticsGroupByType, AnalyticsMetricType, SortOrder };
+import { AnalyticsGroupByType, AnalyticsMetricType, TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionAnalyticsResultItem, GroupByExpressionDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, CampaignClaimAnalyticsFiltersDTO, SortOrder, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserAnalyticsFiltersDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, UserRankingResultItemDTO, UserRankingFiltersDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, BusinessRankingResultItemDTO, BusinessRankingFiltersDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO, RetentionMonthResultDTO, TagAnalyticsRequestDTO, TagAnalyticsResponseDTO, TagUsageDTO, EntityTypeUsageDTO, TaggableEntityType } from '@explorins/pers-shared';
+export { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, TransactionAnalyticsResultItem, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, CampaignClaimAnalyticsFiltersDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserAnalyticsFiltersDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, UserRankingResultItemDTO, UserRankingFiltersDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, BusinessRankingResultItemDTO, BusinessRankingFiltersDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO, RetentionMonthResultDTO, GroupByExpressionDTO, AnalyticsGroupByType, AnalyticsMetricType, SortOrder, TagAnalyticsRequestDTO, TagAnalyticsResponseDTO, TagUsageDTO, EntityTypeUsageDTO, TaggableEntityType };
 //# sourceMappingURL=index.d.ts.map

package/dist/analytics/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,SAAS,EACT,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACV,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,EACpB,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,SAAS,EACT,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EAEvB,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EAET,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EACnB,CAAC"}

package/dist/analytics/services/analytics-service.d.ts

@@ -1,5 +1,5 @@
 import { AnalyticsApi } from '../api/analytics-api';
-import { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO } from '../models';
+import { TransactionAnalyticsRequestDTO, TransactionAnalyticsResponseDTO, CampaignClaimAnalyticsRequestDTO, CampaignClaimAnalyticsResponseDTO, UserAnalyticsRequestDTO, UserAnalyticsResponseDTO, UserRankingAnalyticsRequestDTO, UserRankingAnalyticsResponseDTO, BusinessRankingAnalyticsRequestDTO, BusinessRankingAnalyticsResponseDTO, RetentionAnalyticsRequestDTO, RetentionAnalyticsResponseDTO, TagAnalyticsRequestDTO, TagAnalyticsResponseDTO } from '../models';
 /**
  * Platform-Agnostic Analytics Service
  *
@@ -46,5 +46,12 @@ export declare class AnalyticsService {
      * Replaces 13 separate API calls with 1 efficient query.
      */
     getRetentionAnalytics(request?: RetentionAnalyticsRequestDTO): Promise<RetentionAnalyticsResponseDTO>;
+    /**
+     * ADMIN: Get tag usage analytics across entities
+     *
+     * Aggregates tag usage across all taggable entities for autocomplete,
+     * tag management dashboards, and usage analytics.
+     */
+    getTagAnalytics(request?: TagAnalyticsRequestDTO): Promise<TagAnalyticsResponseDTO>;
 }
 //# sourceMappingURL=analytics-service.d.ts.map

package/dist/analytics/services/analytics-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics-service.d.ts","sourceRoot":"","sources":["../../../src/analytics/services/analytics-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,WAAW,CAAC;AAEnB;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAM9C;;OAEG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAIhH;;OAEG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,iCAAiC,CAAC;IAItH;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIhG;;;;;OAKG;IACG,cAAc,CAAC,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAI5G;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,GAAE,kCAAuC,GAAG,OAAO,CAAC,mCAAmC,CAAC;IAIxH;;;;;OAKG;IACG,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAGhH"}
+{"version":3,"file":"analytics-service.d.ts","sourceRoot":"","sources":["../../../src/analytics/services/analytics-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,mCAAmC,EACnC,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,WAAW,CAAC;AAEnB;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAM9C;;OAEG;IACG,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAIhH;;OAEG;IACG,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,iCAAiC,CAAC;IAItH;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIhG;;;;;OAKG;IACG,cAAc,CAAC,OAAO,GAAE,8BAAmC,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAI5G;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,GAAE,kCAAuC,GAAG,OAAO,CAAC,mCAAmC,CAAC;IAIxH;;;;;OAKG;IACG,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAQ/G;;;;;OAKG;IACG,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAG9F"}

package/dist/analytics.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var analyticsService = require('./chunks/analytics-service-DwkeBB08.cjs');
+var analyticsService = require('./chunks/analytics-service-CF9AsMQH.cjs');
 var persShared = require('@explorins/pers-shared');
 
 

package/dist/analytics.js

@@ -1,3 +1,3 @@
-export { A as AnalyticsApi, a as AnalyticsService } from './chunks/analytics-service-B9IfG6ox.js';
+export { A as AnalyticsApi, a as AnalyticsService } from './chunks/analytics-service-vm7B7LhS.js';
 export { SortOrder } from '@explorins/pers-shared';
 //# sourceMappingURL=analytics.js.map

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

@@ -1,6 +1,22 @@
 import { PersApiClient } from '../../core/pers-api-client';
-import { BusinessMembershipDTO, AddBusinessMemberRequestDTO, UpdateBusinessMembershipRequestDTO, MembershipRole } from '../../shared/interfaces/pers-shared-lib.interfaces';
+import { BusinessMembershipDTO, AddBusinessMemberRequestDTO, UpdateBusinessMembershipRequestDTO, MembershipRole, BusinessMembershipIncludeRelation } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { PaginatedResponseDTO, SortOrder } from '@explorins/pers-shared';
+/**
+ * Options for listing business members
+ */
+export interface GetBusinessMembersOptions {
+    page?: number;
+    limit?: number;
+    role?: MembershipRole;
+    sortBy?: string;
+    sortOrder?: SortOrder;
+    /**
+     * Include related entities in the response.
+     * - 'user': Include full user details in membership.included.user
+     * - 'business': Include full business details in membership.included.business
+     */
+    include?: BusinessMembershipIncludeRelation[];
+}
 /**
  * Business Membership API Client
  *
@@ -47,7 +63,7 @@ export declare class BusinessMembershipApi {
      * Min Role: VIEWER (any member can view)
      *
      * @param businessId - The business UUID
-     * @param options - Pagination and filter options
+     * @param options - Pagination, filter, and include options
      * @returns Paginated array of business memberships with user and role details
      *
      * @throws {AuthenticationError} 401 - Not authenticated
@@ -59,24 +75,22 @@ export declare class BusinessMembershipApi {
      * const page1 = await membershipApi.getMembers('business-123');
      * page1.data.forEach(m => console.log(`${m.userId}: ${m.role}`));
      *
-     * // Filter by role
-     * const admins = await membershipApi.getMembers('business-123', {
-     *   role: MembershipRole.ADMIN,
+     * // Include user data for display
+     * const withUsers = await membershipApi.getMembers('business-123', {
+     *   include: ['user'],
      *   page: 1,
      *   limit: 50
      * });
+     * withUsers.data.forEach(m => console.log(m.included?.user?.email));
      *
-     * // Paginate through all members
-     * const page2 = await membershipApi.getMembers('business-123', { page: 2 });
+     * // Filter by role with user data
+     * const admins = await membershipApi.getMembers('business-123', {
+     *   role: MembershipRole.ADMIN,
+     *   include: ['user']
+     * });
      * ```
      */
-    getMembers(businessId: string, options?: {
-        page?: number;
-        limit?: number;
-        role?: MembershipRole;
-        sortBy?: string;
-        sortOrder?: SortOrder;
-    }): Promise<PaginatedResponseDTO<BusinessMembershipDTO>>;
+    getMembers(businessId: string, options?: GetBusinessMembersOptions): Promise<PaginatedResponseDTO<BusinessMembershipDTO>>;
     /**
      * Add a member to a business
      *

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

@@ -1 +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,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,cAAc,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,GACA,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAkBvD;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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,EACd,iCAAiC,EAClC,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,iCAAiC,EAAE,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAsBvD;;;;;;;;;;;;;;;;;;;;;;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,7 +5,7 @@
  * Focuses on non-admin business operations
  */
 export { BusinessApi } from './api/business-api';
-export { BusinessMembershipApi } from './api/business-membership-api';
+export { BusinessMembershipApi, type GetBusinessMembersOptions } from './api/business-membership-api';
 export { BusinessService } from './services/business-service';
 export { BusinessMembershipService } from './services/business-membership-service';
 //# 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;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"}
+{"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,KAAK,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAGtG,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC"}

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

@@ -1,5 +1,5 @@
 import { PaginatedResponseDTO } from '@explorins/pers-shared';
-import { BusinessMembershipApi } from '../api/business-membership-api';
+import { BusinessMembershipApi, GetBusinessMembersOptions } from '../api/business-membership-api';
 import { BusinessMembershipDTO, MembershipRole } from '../../shared/interfaces/pers-shared-lib.interfaces';
 import { PaginationOptions } from '../../shared/utils/pagination-utils';
 /**
@@ -29,10 +29,17 @@ export declare class BusinessMembershipService {
      * Get all members of a business with pagination
      *
      * @param businessId - The business UUID
-     * @param options - Pagination options
+     * @param options - Pagination and include options
      * @returns Paginated response with business memberships
+     *
+     * @example
+     * ```typescript
+     * // Get members with user data for display
+     * const members = await service.getMembers('biz-123', { include: ['user'] });
+     * members.data.forEach(m => console.log(m.included?.user?.email));
+     * ```
      */
-    getMembers(businessId: string, options?: PaginationOptions): Promise<PaginatedResponseDTO<BusinessMembershipDTO>>;
+    getMembers(businessId: string, options?: GetBusinessMembersOptions): Promise<PaginatedResponseDTO<BusinessMembershipDTO>>;
     /**
      * Get members filtered by role (client-side filtering)
      * @deprecated Consider server-side role filtering for better performance

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

@@ -1 +1 @@
-{"version":3,"file":"business-membership-service.d.ts","sourceRoot":"","sources":["../../../src/business/services/business-membership-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,cAAc,EAEf,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAAyB;IACxB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,qBAAqB;IAMxD;;;;;;OAMG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAIvH;;;OAGG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAavD;;;;;;;;;;;;;;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"}
+{"version":3,"file":"business-membership-service.d.ts","sourceRoot":"","sources":["../../../src/business/services/business-membership-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAClG,OAAO,EACL,qBAAqB,EACrB,cAAc,EAEf,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAAyB;IACxB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,qBAAqB;IAMxD;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAI/H;;;OAGG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAavD;;;;;;;;;;;;;;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"}

package/dist/business.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var businessMembershipService = require('./chunks/business-membership-service-8KC_qRj7.cjs');
+var businessMembershipService = require('./chunks/business-membership-service-BfHzIQlc.cjs');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');
 require('@explorins/pers-shared');
 

package/dist/business.js

@@ -1,4 +1,4 @@
-export { B as BusinessApi, a as BusinessMembershipApi, c as BusinessMembershipService, b as BusinessService } from './chunks/business-membership-service-D6vaVQTR.js';
+export { B as BusinessApi, a as BusinessMembershipApi, c as BusinessMembershipService, b as BusinessService } from './chunks/business-membership-service-CFa-TI39.js';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 import '@explorins/pers-shared';
 //# sourceMappingURL=business.js.map

package/dist/chunks/{analytics-service-DwkeBB08.cjs → analytics-service-CF9AsMQH.cjs}

@@ -203,6 +203,57 @@ class AnalyticsApi {
     async getRetentionAnalytics(request = {}) {
         return this.apiClient.post('/analytics/users/retention', request);
     }
+    // ==========================================
+    // TAG ANALYTICS
+    // ==========================================
+    /**
+     * ADMIN: Get tag usage analytics across entities
+     *
+     * Aggregates tag usage across all taggable entities (campaigns, redemptions,
+     * businesses, token metadata, user status types). Perfect for:
+     * - Tag autocomplete/suggestions
+     * - Tag management dashboards
+     * - Usage analytics
+     *
+     * @param request - Optional filters for entity types
+     * @returns Aggregated tag usage with per-entity-type breakdown
+     *
+     * @example Get all tags across all entities
+     * ```typescript
+     * const allTags = await analyticsApi.getTagAnalytics();
+     * console.log(`${allTags.totalTags} unique tags, ${allTags.totalUsage} total usages`);
+     *
+     * // Use for autocomplete suggestions
+     * const suggestions = allTags.tags.map(t => t.tag);
+     * ```
+     *
+     * @example Get tags only from campaigns and businesses
+     * ```typescript
+     * const filteredTags = await analyticsApi.getTagAnalytics({
+     *   entityTypes: [TaggableEntityType.CAMPAIGN, TaggableEntityType.BUSINESS]
+     * });
+     * ```
+     *
+     * @example Tag usage breakdown
+     * ```typescript
+     * const analytics = await analyticsApi.getTagAnalytics();
+     * analytics.tags.forEach(({ tag, count, usageByEntityType }) => {
+     *   console.log(`${tag}: ${count} total`);
+     *   usageByEntityType.forEach(({ entityType, count }) => {
+     *     console.log(`  - ${entityType}: ${count}`);
+     *   });
+     * });
+     * ```
+     */
+    async getTagAnalytics(request = {}) {
+        const params = new URLSearchParams();
+        if (request.entityTypes?.length) {
+            params.set('entityTypes', request.entityTypes.join(','));
+        }
+        const queryString = params.toString();
+        const url = queryString ? `/analytics/tags?${queryString}` : '/analytics/tags';
+        return this.apiClient.get(url);
+    }
 }
 
 /**
@@ -267,8 +318,20 @@ class AnalyticsService {
     async getRetentionAnalytics(request = {}) {
         return this.analyticsApi.getRetentionAnalytics(request);
     }
+    // ==========================================
+    // TAG ANALYTICS
+    // ==========================================
+    /**
+     * ADMIN: Get tag usage analytics across entities
+     *
+     * Aggregates tag usage across all taggable entities for autocomplete,
+     * tag management dashboards, and usage analytics.
+     */
+    async getTagAnalytics(request = {}) {
+        return this.analyticsApi.getTagAnalytics(request);
+    }
 }
 
 exports.AnalyticsApi = AnalyticsApi;
 exports.AnalyticsService = AnalyticsService;
-//# sourceMappingURL=analytics-service-DwkeBB08.cjs.map
+//# sourceMappingURL=analytics-service-CF9AsMQH.cjs.map

package/dist/chunks/analytics-service-CF9AsMQH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-service-CF9AsMQH.cjs","sources":["../../src/analytics/api/analytics-api.ts","../../src/analytics/services/analytics-service.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/chunks/{analytics-service-B9IfG6ox.js → analytics-service-vm7B7LhS.js}

@@ -201,6 +201,57 @@ class AnalyticsApi {
     async getRetentionAnalytics(request = {}) {
         return this.apiClient.post('/analytics/users/retention', request);
     }
+    // ==========================================
+    // TAG ANALYTICS
+    // ==========================================
+    /**
+     * ADMIN: Get tag usage analytics across entities
+     *
+     * Aggregates tag usage across all taggable entities (campaigns, redemptions,
+     * businesses, token metadata, user status types). Perfect for:
+     * - Tag autocomplete/suggestions
+     * - Tag management dashboards
+     * - Usage analytics
+     *
+     * @param request - Optional filters for entity types
+     * @returns Aggregated tag usage with per-entity-type breakdown
+     *
+     * @example Get all tags across all entities
+     * ```typescript
+     * const allTags = await analyticsApi.getTagAnalytics();
+     * console.log(`${allTags.totalTags} unique tags, ${allTags.totalUsage} total usages`);
+     *
+     * // Use for autocomplete suggestions
+     * const suggestions = allTags.tags.map(t => t.tag);
+     * ```
+     *
+     * @example Get tags only from campaigns and businesses
+     * ```typescript
+     * const filteredTags = await analyticsApi.getTagAnalytics({
+     *   entityTypes: [TaggableEntityType.CAMPAIGN, TaggableEntityType.BUSINESS]
+     * });
+     * ```
+     *
+     * @example Tag usage breakdown
+     * ```typescript
+     * const analytics = await analyticsApi.getTagAnalytics();
+     * analytics.tags.forEach(({ tag, count, usageByEntityType }) => {
+     *   console.log(`${tag}: ${count} total`);
+     *   usageByEntityType.forEach(({ entityType, count }) => {
+     *     console.log(`  - ${entityType}: ${count}`);
+     *   });
+     * });
+     * ```
+     */
+    async getTagAnalytics(request = {}) {
+        const params = new URLSearchParams();
+        if (request.entityTypes?.length) {
+            params.set('entityTypes', request.entityTypes.join(','));
+        }
+        const queryString = params.toString();
+        const url = queryString ? `/analytics/tags?${queryString}` : '/analytics/tags';
+        return this.apiClient.get(url);
+    }
 }
 
 /**
@@ -265,7 +316,19 @@ class AnalyticsService {
     async getRetentionAnalytics(request = {}) {
         return this.analyticsApi.getRetentionAnalytics(request);
     }
+    // ==========================================
+    // TAG ANALYTICS
+    // ==========================================
+    /**
+     * ADMIN: Get tag usage analytics across entities
+     *
+     * Aggregates tag usage across all taggable entities for autocomplete,
+     * tag management dashboards, and usage analytics.
+     */
+    async getTagAnalytics(request = {}) {
+        return this.analyticsApi.getTagAnalytics(request);
+    }
 }
 
 export { AnalyticsApi as A, AnalyticsService as a };
-//# sourceMappingURL=analytics-service-B9IfG6ox.js.map
+//# sourceMappingURL=analytics-service-vm7B7LhS.js.map

package/dist/chunks/analytics-service-vm7B7LhS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-service-vm7B7LhS.js","sources":["../../src/analytics/api/analytics-api.ts","../../src/analytics/services/analytics-service.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/chunks/{base-token-service-Pvja-ykj.cjs → base-token-service-Bu7ufXtf.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var tokenService = require('./token-service-BlbXrxnS.cjs');
+var tokenService = require('./token-service-C1xe11OX.cjs');
 
 /**
  * Token SDK - Class-based Promise SDK for Token Operations
@@ -78,6 +78,16 @@ class TokenSDK {
     async createTokenMetadata(tokenId, tokenData) {
         return this.tokenService.createTokenMetadata(tokenId, tokenData);
     }
+    /**
+     * Update token metadata (ERC721 only)
+     * Note: Existing minted NFTs retain their original metadata - this only affects future mints
+     * @param metadataId - The metadata ID to update
+     * @param tokenData - The token storage data
+     * @returns Promise with the updated metadata
+     */
+    async updateTokenMetadata(metadataId, tokenData) {
+        return this.tokenService.updateTokenMetadata(metadataId, tokenData);
+    }
     /**
      * Toggle token active status
      * @param tokenId - The token ID to toggle
@@ -356,4 +366,4 @@ class BaseTokenService {
 exports.BaseTokenService = BaseTokenService;
 exports.TokenSDK = TokenSDK;
 exports.getMetadataFromTokenUnitResponse = getMetadataFromTokenUnitResponse;
-//# sourceMappingURL=base-token-service-Pvja-ykj.cjs.map
+//# sourceMappingURL=base-token-service-Bu7ufXtf.cjs.map

package/dist/chunks/base-token-service-Bu7ufXtf.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-token-service-Bu7ufXtf.cjs","sources":["../../src/token/token-sdk.ts","../../src/token/utils.ts","../../src/token/base/base-token-service.ts"],"sourcesContent":[null,null,null],"names":["TokenApi","TokenService","TokenBusinessService"],"mappings":";;;;AAaA;;;;;;;;;;AAUG;MACU,QAAQ,CAAA;AAInB,IAAA,WAAA,CAAY,SAAwB,EAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAIA,qBAAQ,CAAC,SAAS,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,IAAIC,yBAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;IACrD;;;;;AAOA;;;AAGG;AACH,IAAA,MAAM,SAAS,GAAA;AACb,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE;IAC5C;AAEA;;;AAGG;AACH,IAAA,MAAM,aAAa,GAAA;AACjB,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE;IAChD;AAEA;;;AAGG;AACH,IAAA,MAAM,oBAAoB,GAAA;AACxB,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,0BAA0B,EAAE;IACvD;AAEA;;;AAGG;AACH,IAAA,MAAM,eAAe,GAAA;AACnB,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE;IAClD;AAEA;;;AAGG;AACH,IAAA,MAAM,eAAe,GAAA;AACnB,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE;IAClD;AAEA;;;;;AAKG;AACH,IAAA,MAAM,kBAAkB,CAAC,eAAuB,EAAE,kBAAiC,IAAI,EAAA;QACrF,OAAO,IAAI,CAAC,YAAY,CAAC,yBAAyB,CAAC,eAAe,EAAE,eAAe,CAAC;IACtF;;;;AAMA;;;;;AAKG;AACH,IAAA,MAAM,mBAAmB,CAAC,OAAe,EAAE,SAA2B,EAAA;QACpE,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC;IAClE;AAEA;;;;;;AAMG;AACH,IAAA,MAAM,mBAAmB,CAAC,UAAkB,EAAE,SAA2B,EAAA;QACvE,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC;IACrE;AAEA;;;;AAIG;IACH,MAAM,iBAAiB,CAAC,OAAe,EAAA;QACrC,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,OAAO,CAAC;IACrD;AAEA;;;;AAIG;IACH,MAAM,WAAW,CAAC,SAAgC,EAAA;QAChD,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,SAAS,CAAC;IACjD;AAEA;;;;;AAKG;AACH,IAAA,MAAM,WAAW,CAAC,OAAe,EAAE,SAAgC,EAAA;QACjE,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC;IAC1D;AAEA;;;;;;AAMG;AACH,IAAA,MAAM,kBAAkB,CAAC,OAAe,EAAE,eAAuB,EAAE,OAAe,EAAA;AAChF,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC;IAChF;AAEA;;;;AAIG;IACH,MAAM,yBAAyB,CAAC,UAAkB,EAAA;QAChD,OAAO,IAAI,CAAC,YAAY,CAAC,yBAAyB,CAAC,UAAU,CAAC;IAChE;AAEA;;;;AAIG;IACH,MAAM,eAAe,CAAC,SAAuB,EAAA;QAC3C,OAAO,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC;IACrD;;;;AAMA;;;AAGG;IACH,eAAe,GAAA;QACb,OAAO,IAAI,CAAC,YAAY;IAC1B;AAEA;;;AAGG;IACH,WAAW,GAAA;QACT,OAAO,IAAI,CAAC,QAAQ;IACtB;AACD;;AC3LD;AACA;AACA;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDG;AACG,SAAU,gCAAgC,CAC9C,SAAuB,EACvB,aAAsB,EAAA;;AAGtB,IAAA,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;AACvE,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ;;AAGzC,IAAA,MAAM,QAAQ,GAAG,aAAa,IAAI,SAAS,CAAC,0BAA0B;AAEtE,IAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;AAC1B,QAAA,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAmB,KAAM,CAAS,CAAC,aAAa,KAAK,QAAQ,CAAC;AAC3F,QAAA,IAAI,KAAK;AAAE,YAAA,OAAO,KAAK;IACzB;;AAGA,IAAA,OAAO,QAAQ,CAAC,CAAC,CAAC;AACpB;;AChEA;;;;;;;;;;;;AAYG;MACmB,gBAAgB,CAAA;AAAtC,IAAA,WAAA,GAAA;QAIU,IAAA,CAAA,cAAc,GAAG,KAAK;IAyIhC;;;;AAnIE;;;AAGG;AACO,IAAA,sBAAsB,CAAC,SAAwB,EAAA;QACvD,IAAI,CAAC,SAAS,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC;QACnF;AAEA,QAAA,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;YACxB,IAAI,CAAC,SAAS,GAAG,IAAID,qBAAQ,CAAC,SAAS,CAAC;YACxC,IAAI,CAAC,qBAAqB,GAAG,IAAIE,yBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC;AACrE,YAAA,IAAI,CAAC,cAAc,GAAG,IAAI;QAC5B;IACF;AAEA;;AAEG;AACH,IAAA,IAAc,yBAAyB,GAAA;QACrC,OAAO,IAAI,CAAC,cAAc;IAC5B;AAEA;;AAEG;AACH,IAAA,IAAY,oBAAoB,GAAA;AAC9B,QAAA,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE;AAC/B,YAAA,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC;QAChG;QACA,OAAO,IAAI,CAAC,qBAAqB;IACnC;;;;AAMA;;AAEG;IACI,eAAe,GAAA;AACpB,QAAA,OAAO,IAAI,CAAC,oBAAoB,CAAC,eAAe,EAAE;IACpD;AAEA;;AAEG;IACI,mBAAmB,GAAA;AACxB,QAAA,OAAO,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,EAAE;IACxD;AAEA;;AAEG;IACI,0BAA0B,GAAA;AAC/B,QAAA,OAAO,IAAI,CAAC,oBAAoB,CAAC,0BAA0B,EAAE;IAC/D;AAEA;;AAEG;IACI,qBAAqB,GAAA;AAC1B,QAAA,OAAO,IAAI,CAAC,oBAAoB,CAAC,qBAAqB,EAAE;IAC1D;AAEA;;AAEG;IACI,qBAAqB,GAAA;AAC1B,QAAA,OAAO,IAAI,CAAC,oBAAoB,CAAC,qBAAqB,EAAE;IAC1D;AAEA;;AAEG;IACI,yBAAyB,CAAC,eAAuB,EAAE,eAA8B,EAAA;QACtF,OAAO,IAAI,CAAC,oBAAoB,CAAC,yBAAyB,CAAC,eAAe,EAAE,eAAe,CAAC;IAC9F;;;;AAMA;;AAEG;IACI,mBAAmB,CAAC,OAAe,EAAE,SAA2B,EAAA;QACrE,OAAO,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC;IAC1E;AAEA;;AAEG;AACI,IAAA,iBAAiB,CAAC,OAAe,EAAA;QACtC,OAAO,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,OAAO,CAAC;IAC7D;AAEA;;AAEG;AACI,IAAA,WAAW,CAAC,SAAgC,EAAA;QACjD,OAAO,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,SAAS,CAAC;IACzD;AAEA;;AAEG;IACI,WAAW,CAAC,OAAe,EAAE,SAAgC,EAAA;QAClE,OAAO,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC;IAClE;AAEA;;AAEG;AACI,IAAA,kBAAkB,CAAC,OAAe,EAAE,eAAuB,EAAE,OAAe,EAAA;AACjF,QAAA,OAAO,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC;IACxF;AAEA;;AAEG;AACI,IAAA,yBAAyB,CAAC,UAAkB,EAAA;QACjD,OAAO,IAAI,CAAC,oBAAoB,CAAC,yBAAyB,CAAC,UAAU,CAAC;IACxE;AAEA;;AAEG;AACI,IAAA,eAAe,CAAC,SAAuB,EAAA;QAC5C,OAAO,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,SAAS,CAAC;IAC7D;AACD;;;;;;"}

package/dist/chunks/{base-token-service-U3YzHxfd.js → base-token-service-C838kf06.js}

@@ -1,4 +1,4 @@
-import { T as TokenApi, a as TokenService } from './token-service-Bfj6C0yz.js';
+import { T as TokenApi, a as TokenService } from './token-service-BxEO5YVN.js';
 
 /**
  * Token SDK - Class-based Promise SDK for Token Operations
@@ -76,6 +76,16 @@ class TokenSDK {
     async createTokenMetadata(tokenId, tokenData) {
         return this.tokenService.createTokenMetadata(tokenId, tokenData);
     }
+    /**
+     * Update token metadata (ERC721 only)
+     * Note: Existing minted NFTs retain their original metadata - this only affects future mints
+     * @param metadataId - The metadata ID to update
+     * @param tokenData - The token storage data
+     * @returns Promise with the updated metadata
+     */
+    async updateTokenMetadata(metadataId, tokenData) {
+        return this.tokenService.updateTokenMetadata(metadataId, tokenData);
+    }
     /**
      * Toggle token active status
      * @param tokenId - The token ID to toggle
@@ -352,4 +362,4 @@ class BaseTokenService {
 }
 
 export { BaseTokenService as B, TokenSDK as T, getMetadataFromTokenUnitResponse as g };
-//# sourceMappingURL=base-token-service-U3YzHxfd.js.map
+//# sourceMappingURL=base-token-service-C838kf06.js.map

package/dist/chunks/base-token-service-C838kf06.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-token-service-C838kf06.js","sources":["../../src/token/token-sdk.ts","../../src/token/utils.ts","../../src/token/base/base-token-service.ts"],"sourcesContent":[null,null,null],"names":["TokenBusinessService"],"mappings":"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"}

package/dist/chunks/{business-membership-service-8KC_qRj7.cjs → business-membership-service-BfHzIQlc.cjs}

@@ -233,7 +233,7 @@ class BusinessMembershipApi {
      * Min Role: VIEWER (any member can view)
      *
      * @param businessId - The business UUID
-     * @param options - Pagination and filter options
+     * @param options - Pagination, filter, and include options
      * @returns Paginated array of business memberships with user and role details
      *
      * @throws {AuthenticationError} 401 - Not authenticated
@@ -245,15 +245,19 @@ class BusinessMembershipApi {
      * const page1 = await membershipApi.getMembers('business-123');
      * page1.data.forEach(m => console.log(`${m.userId}: ${m.role}`));
      *
-     * // Filter by role
-     * const admins = await membershipApi.getMembers('business-123', {
-     *   role: MembershipRole.ADMIN,
+     * // Include user data for display
+     * const withUsers = await membershipApi.getMembers('business-123', {
+     *   include: ['user'],
      *   page: 1,
      *   limit: 50
      * });
+     * withUsers.data.forEach(m => console.log(m.included?.user?.email));
      *
-     * // Paginate through all members
-     * const page2 = await membershipApi.getMembers('business-123', { page: 2 });
+     * // Filter by role with user data
+     * const admins = await membershipApi.getMembers('business-123', {
+     *   role: MembershipRole.ADMIN,
+     *   include: ['user']
+     * });
      * ```
      */
     async getMembers(businessId, options) {
@@ -261,6 +265,9 @@ class BusinessMembershipApi {
         if (options?.role) {
             params.set('role', options.role);
         }
+        if (options?.include?.length) {
+            params.set('include', options.include.join(','));
+        }
         const response = await this.apiClient.get(`${this.getMembersPath(businessId)}?${params.toString()}`);
         return paginationUtils.normalizeToPaginated(response);
     }
@@ -520,8 +527,15 @@ class BusinessMembershipService {
      * Get all members of a business with pagination
      *
      * @param businessId - The business UUID
-     * @param options - Pagination options
+     * @param options - Pagination and include options
      * @returns Paginated response with business memberships
+     *
+     * @example
+     * ```typescript
+     * // Get members with user data for display
+     * const members = await service.getMembers('biz-123', { include: ['user'] });
+     * members.data.forEach(m => console.log(m.included?.user?.email));
+     * ```
      */
     async getMembers(businessId, options) {
         return this.membershipApi.getMembers(businessId, options);
@@ -753,4 +767,4 @@ exports.BusinessApi = BusinessApi;
 exports.BusinessMembershipApi = BusinessMembershipApi;
 exports.BusinessMembershipService = BusinessMembershipService;
 exports.BusinessService = BusinessService;
-//# sourceMappingURL=business-membership-service-8KC_qRj7.cjs.map
+//# sourceMappingURL=business-membership-service-BfHzIQlc.cjs.map