@explorins/pers-sdk 1.1.2 → 1.1.3

package/dist/auth-admin.js

@@ -0,0 +1,92 @@
+/**
+ * Platform-Agnostic Auth Admin API Client
+ *
+ * Handles authentication and authorization admin operations using the PERS backend.
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ *
+ * Note: Special header handling (bypass-auth-interceptor) may need to be implemented
+ * at the PersApiClient level or through a specialized auth client.
+ */
+class AuthAdminApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/auth';
+    }
+    // ==========================================
+    // ADMIN AUTHENTICATION OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Login tenant admin with JWT
+     * Note: JWT handling and auth bypass headers may need special implementation
+     */
+    async loginTenantAdmin(jwt) {
+        // TODO: Implement proper JWT and bypass header handling when PersApiClient supports it
+        return this.apiClient.post(`${this.basePath}/token`, {});
+    }
+    /**
+     * ADMIN: Refresh access token
+     * Note: Bypass header handling may need special implementation
+     */
+    async refreshAccessToken(refreshToken) {
+        return this.apiClient.post(`${this.basePath}/refresh`, { refreshToken });
+    }
+}
+
+/**
+ * Platform-Agnostic Auth Admin Service
+ *
+ * Contains auth admin business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ */
+class AuthAdminService {
+    constructor(authAdminApi) {
+        this.authAdminApi = authAdminApi;
+    }
+    // ==========================================
+    // ADMIN AUTHENTICATION OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Login tenant admin with JWT
+     */
+    async loginTenantAdmin(jwt) {
+        return this.authAdminApi.loginTenantAdmin(jwt);
+    }
+    /**
+     * ADMIN: Refresh access token
+     */
+    async refreshAccessToken(refreshToken) {
+        return this.authAdminApi.refreshAccessToken(refreshToken);
+    }
+}
+
+/**
+ * @explorins/pers-sdk-auth-admin
+ *
+ * Platform-agnostic Auth Admin Domain SDK for PERS ecosystem
+ * Handles authentication and authorization admin operations
+ */
+// API Layer
+/**
+ * Create a complete Auth Admin SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns Auth Admin SDK with flattened structure for better DX
+ */
+function createAuthAdminSDK(apiClient) {
+    const authAdminApi = new AuthAdminApi(apiClient);
+    const authAdminService = new AuthAdminService(authAdminApi);
+    return {
+        // Direct access to service methods (primary interface)
+        // Admin authentication methods
+        loginTenantAdmin: (jwt) => authAdminService.loginTenantAdmin(jwt),
+        refreshAccessToken: (refreshToken) => authAdminService.refreshAccessToken(refreshToken),
+        // Advanced access for edge cases
+        api: authAdminApi,
+        service: authAdminService
+    };
+}
+
+export { AuthAdminApi, AuthAdminService, createAuthAdminSDK };
+//# sourceMappingURL=auth-admin.js.map

package/dist/auth-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-admin.js","sources":["../../src/auth-admin/api/auth-admin-api.ts","../../src/auth-admin/services/auth-admin-service.ts","../../src/auth-admin/index.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":"AAOA;;;;;;;;AAQG;MACU,YAAY,CAAA;AACvB,IAAA,WAAA,CAAoB,SAAwB,EAAA;QAAxB,IAAA,CAAA,SAAS,GAAT,SAAS;QAEZ,IAAA,CAAA,QAAQ,GAAG,OAAO;IAFY;;;;AAQ/C;;;AAGG;IACH,MAAM,gBAAgB,CAAC,GAAW,EAAA;;AAEhC,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAwB,CAAA,EAAG,IAAI,CAAC,QAAQ,CAAA,MAAA,CAAQ,EAAE,EAAE,CAAC;IACjF;AAEA;;;AAGG;IACH,MAAM,kBAAkB,CAAC,YAAoB,EAAA;AAC3C,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAuB,CAAA,EAAG,IAAI,CAAC,QAAQ,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC;IAChG;AACD;;AClCD;;;;;;;AAOG;MACU,gBAAgB,CAAA;AAC3B,IAAA,WAAA,CAAoB,YAA0B,EAAA;QAA1B,IAAA,CAAA,YAAY,GAAZ,YAAY;IAAiB;;;;AAMjD;;AAEG;IACH,MAAM,gBAAgB,CAAC,GAAW,EAAA;QAChC,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,GAAG,CAAC;IAChD;AAEA;;AAEG;IACH,MAAM,kBAAkB,CAAC,YAAoB,EAAA;QAC3C,OAAO,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,YAAY,CAAC;IAC3D;AACD;;ACnCD;;;;;AAKG;AAEH;AAgBA;;;;;AAKG;AACG,SAAU,kBAAkB,CAAC,SAAwB,EAAA;AACzD,IAAA,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC;AAChD,IAAA,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,YAAY,CAAC;IAE3D,OAAO;;;QAIL,gBAAgB,EAAE,CAAC,GAAW,KAAK,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,CAAC;QACzE,kBAAkB,EAAE,CAAC,YAAoB,KAAK,gBAAgB,CAAC,kBAAkB,CAAC,YAAY,CAAC;;AAG/F,QAAA,GAAG,EAAE,YAAY;AACjB,QAAA,OAAO,EAAE;KACV;AACH;;;;"}

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

@@ -0,0 +1,133 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO, BusinessCreateRequestDTO, BusinessApiKeyDTO, BusinessTokenBalancesDTO, BusinessTypeCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * Platform-Agnostic Business API Client
+ *
+ * Updated to match the new RESTful /businesses endpoints.
+ * Uses @explorins/pers-shared DTOs for full type safety and consistency with backend.
+ */
+export declare class BusinessApi {
+    private apiClient;
+    constructor(apiClient: PersApiClient);
+    private readonly basePath;
+    /**
+     * Get all business types (project key required)
+     *
+     * Endpoint: GET /businesses/types
+     * Auth: @ApiSecurity('projectKey')
+     */
+    getAllBusinessTypes(): Promise<BusinessTypeDTO[]>;
+    /**
+     * ADMIN: Create business type
+     *
+     * Endpoint: POST /businesses/types
+     * Auth: @TenantAdmin()
+     */
+    createBusinessType(dto: BusinessTypeCreateRequestDTO): Promise<BusinessTypeDTO>;
+    /**
+     * ADMIN: Update business type
+     *
+     * Endpoint: PUT /businesses/types
+     * Auth: @TenantAdmin()
+     */
+    updateBusinessType(dto: BusinessTypeDTO): Promise<BusinessTypeDTO>;
+    /**
+     * ADMIN: Delete business type
+     *
+     * Endpoint: DELETE /businesses/types/{id}
+     * Auth: @TenantAdmin()
+     */
+    deleteBusinessType(id: number): Promise<boolean>;
+    /**
+     * Get current business info (business authentication required)
+     *
+     * Endpoint: GET /businesses/me
+     * Auth: @Business()
+     */
+    getCurrentBusiness(): Promise<BusinessTokenBalancesDTO>;
+    /**
+     * Get all active businesses (project key required)
+     *
+     * Endpoint: GET /businesses
+     * Auth: @ApiSecurity('projectKey')
+     * Note: Regular users automatically get active businesses only
+     */
+    getActiveBusinesses(): Promise<BusinessDTO[]>;
+    /**
+     * Get all businesses with filtering (admin users can access inactive)
+     *
+     * Endpoint: GET /businesses?active={boolean}&sanitize={mode}
+     * Auth: @ApiSecurity('projectKey') (enhanced with role-based filtering)
+     */
+    getAllBusinesses(options?: {
+        active?: boolean;
+        sanitize?: 'soft' | 'hard';
+    }): Promise<BusinessDTO[]>;
+    /**
+     * ADMIN: Get all businesses (admin endpoint with full access)
+     *
+     * Endpoint: GET /businesses/admin
+     * Auth: @TenantAdmin()
+     */
+    getAllBusinessesAdmin(options?: {
+        active?: boolean;
+        sanitize?: 'soft' | 'hard';
+    }): Promise<BusinessDTO[]>;
+    /**
+     * Get business by ID
+     *
+     * Endpoint: GET /businesses/{id}
+     * Auth: @ApiSecurity('projectKey')
+     */
+    getBusinessById(businessId: string): Promise<BusinessDTO>;
+    /**
+     * Get business by account address
+     *
+     * Endpoint: GET /businesses/account/{accountAddress}
+     * Auth: @ApiSecurity('projectKey')
+     */
+    getBusinessByAccount(accountAddress: string): Promise<BusinessDTO>;
+    /**
+     * ADMIN: Create business
+     *
+     * Endpoint: POST /businesses
+     * Auth: @TenantAdmin()
+     * Returns: BusinessApiKeyDTO | BusinessTokenBalancesDTO
+     */
+    createBusiness(dto: BusinessCreateRequestDTO): Promise<BusinessApiKeyDTO | BusinessTokenBalancesDTO>;
+    /**
+     * ADMIN: Create business by display name (convenience method)
+     *
+     * This is a convenience wrapper that creates the proper DTO structure
+     */
+    createBusinessByDisplayName(displayName: string): Promise<BusinessApiKeyDTO | BusinessTokenBalancesDTO>;
+    /**
+     * ADMIN: Create businesses from URL
+     *
+     * Endpoint: POST /businesses/bulk/url
+     * Auth: @TenantAdmin()
+     */
+    createBusinessesFromUrl(url: string): Promise<BusinessDTO[]>;
+    /**
+     * ADMIN: Update business
+     *
+     * Endpoint: PUT /businesses/{id}
+     * Auth: @TenantAdmin()
+     */
+    updateBusiness(id: string, businessData: BusinessUpdateRequestDTO): Promise<BusinessDTO>;
+    /**
+     * ADMIN: Toggle business active status
+     *
+     * Endpoint: PUT /businesses/{id}/activate
+     * Auth: @TenantAdmin()
+     */
+    toggleBusinessActive(id: string, isActive: boolean): Promise<BusinessDTO>;
+    /**
+     * ADMIN: Generate new business API key
+     *
+     * Endpoint: PUT /businesses/{id}/api-key
+     * Auth: @TenantAdmin()
+     */
+    generateNewBusinessApiKey(id: string): Promise<string>;
+}
+//# sourceMappingURL=business-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"business-api.d.ts","sourceRoot":"","sources":["../../../src/business/api/business-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EAExB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,oDAAoD,CAAC;AAE5D;;;;;GAKG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAM1C;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIvD;;;;;OAKG;IACG,kBAAkB,CAAC,GAAG,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAIrF;;;;;OAKG;IACG,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAIxE;;;;;OAKG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtD;;;;;OAKG;IACG,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAI7D;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAInD;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE;QAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiB1B;;;;;OAKG;IACG,qBAAqB,CAAC,OAAO,CAAC,EAAE;QACpC,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiB1B;;;;;OAKG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/D;;;;;OAKG;IACG,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxE;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,GAAG,wBAAwB,CAAC;IAI1G;;;;OAIG;IACG,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,wBAAwB,CAAC;IAS7G;;;;;OAKG;IACG,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIlE;;;;;OAKG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI9F;;;;;OAKG;IACG,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAK/E;;;;;OAKG;IACG,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG7D"}

package/dist/business/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @explorins/pers-sdk-business
+ *
+ * Platform-agnostic Business Domain SDK for PERS ecosystem
+ * Focuses on non-admin business operations
+ */
+export { BusinessApi } from './api/business-api';
+export { BusinessService } from './services/business-service';
+export * from '../shared/interfaces/pers-shared-lib.interfaces';
+import { BusinessUpdateRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
+import { PersApiClient } from '../core/pers-api-client';
+import { BusinessApi } from './api/business-api';
+import { BusinessService } from './services/business-service';
+/**
+ * Create a complete Business SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns Business SDK with flattened structure for better DX
+ */
+export declare function createBusinessSDK(apiClient: PersApiClient): {
+    getActiveBusinesses: () => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO[]>;
+    getAllBusinessTypes: () => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business-type.dto").BusinessTypeDTO[]>;
+    getBusinessById: (businessId: string) => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO>;
+    getBusinessByAccount: (accountAddress: string) => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO>;
+    getBusinessesByType: (typeId: string) => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO[]>;
+    getAllBusinesses: () => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO[]>;
+    createBusinessByDisplayName: (displayName: string) => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO>;
+    updateBusiness: (id: string, businessData: BusinessUpdateRequestDTO) => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO>;
+    toggleBusinessActive: (id: string, isActive: boolean) => Promise<import("@explorins/pers-shared/dist/cjs/dto/business/business.dto").BusinessDTO>;
+    api: BusinessApi;
+    service: BusinessService;
+};
+export type BusinessSDK = ReturnType<typeof createBusinessSDK>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;AAEhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAE3F,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,aAAa;;;kCAQxB,MAAM;2CACG,MAAM;kCACf,MAAM;;+CAIO,MAAM;yBAC5B,MAAM,gBAAgB,wBAAwB;+BACxC,MAAM,YAAY,OAAO;;;EAMvD;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Business Domain Models
+ *
+ * Re-exports from @explorins/pers-shared for consistency with backend
+ * and to provide a single import source for business-related types.
+ */
+export type { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/business/models/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,WAAW,EACX,eAAe,EACf,wBAAwB,EACzB,MAAM,oDAAoD,CAAC"}

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

@@ -0,0 +1,51 @@
+import { BusinessApi } from '../api/business-api';
+import { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
+/**
+ * Platform-Agnostic Business Service
+ *
+ * Contains business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ */
+export declare class BusinessService {
+    private businessApi;
+    constructor(businessApi: BusinessApi);
+    /**
+     * Get all active businesses
+     */
+    getActiveBusinesses(): Promise<BusinessDTO[]>;
+    /**
+     * Get all business types
+     */
+    getAllBusinessTypes(): Promise<BusinessTypeDTO[]>;
+    /**
+     * Get business by ID
+     */
+    getBusinessById(businessId: string): Promise<BusinessDTO>;
+    /**
+     * Get business by account address
+     */
+    getBusinessByAccount(accountAddress: string): Promise<BusinessDTO>;
+    /**
+     * Get businesses by type (client-side filtering)
+     */
+    getBusinessesByType(typeId: string): Promise<BusinessDTO[]>;
+    /**
+     * ADMIN: Get all businesses (active and inactive)
+     */
+    getAllBusinesses(): Promise<BusinessDTO[]>;
+    /**
+     * ADMIN: Create business by display name
+     */
+    createBusinessByDisplayName(displayName: string): Promise<BusinessDTO>;
+    /**
+     * ADMIN: Update business
+     */
+    updateBusiness(id: string, businessData: BusinessUpdateRequestDTO): Promise<BusinessDTO>;
+    /**
+     * ADMIN: Toggle business active status
+     */
+    toggleBusinessActive(id: string, isActive: boolean): Promise<BusinessDTO>;
+}
+//# sourceMappingURL=business-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"business-service.d.ts","sourceRoot":"","sources":["../../../src/business/services/business-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,WAAW,EACX,eAAe,EACf,wBAAwB,EACzB,MAAM,oDAAoD,CAAC;AAE5D;;;;;;;GAOG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAE5C;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAInD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIvD;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/D;;OAEG;IACG,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxE;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAWjE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIhD;;OAEG;IACG,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5E;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI9F;;OAEG;IACG,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;CAGhF"}

package/dist/business.cjs

@@ -0,0 +1,303 @@
+'use strict';
+
+/**
+ * Platform-Agnostic Business API Client
+ *
+ * Updated to match the new RESTful /businesses endpoints.
+ * Uses @explorins/pers-shared DTOs for full type safety and consistency with backend.
+ */
+class BusinessApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/businesses';
+    }
+    // ==========================================
+    // 🌐 BUSINESS TYPES MANAGEMENT
+    // ==========================================
+    /**
+     * Get all business types (project key required)
+     *
+     * Endpoint: GET /businesses/types
+     * Auth: @ApiSecurity('projectKey')
+     */
+    async getAllBusinessTypes() {
+        return this.apiClient.get(`${this.basePath}/types`);
+    }
+    /**
+     * ADMIN: Create business type
+     *
+     * Endpoint: POST /businesses/types
+     * Auth: @TenantAdmin()
+     */
+    async createBusinessType(dto) {
+        return this.apiClient.post(`${this.basePath}/types`, dto);
+    }
+    /**
+     * ADMIN: Update business type
+     *
+     * Endpoint: PUT /businesses/types
+     * Auth: @TenantAdmin()
+     */
+    async updateBusinessType(dto) {
+        return this.apiClient.put(`${this.basePath}/types`, dto);
+    }
+    /**
+     * ADMIN: Delete business type
+     *
+     * Endpoint: DELETE /businesses/types/{id}
+     * Auth: @TenantAdmin()
+     */
+    async deleteBusinessType(id) {
+        return this.apiClient.delete(`${this.basePath}/types/${id}`);
+    }
+    // ==========================================
+    // 🏢 BUSINESS MANAGEMENT
+    // ==========================================
+    /**
+     * Get current business info (business authentication required)
+     *
+     * Endpoint: GET /businesses/me
+     * Auth: @Business()
+     */
+    async getCurrentBusiness() {
+        return this.apiClient.get(`${this.basePath}/me`);
+    }
+    /**
+     * Get all active businesses (project key required)
+     *
+     * Endpoint: GET /businesses
+     * Auth: @ApiSecurity('projectKey')
+     * Note: Regular users automatically get active businesses only
+     */
+    async getActiveBusinesses() {
+        return this.apiClient.get(`${this.basePath}`);
+    }
+    /**
+     * Get all businesses with filtering (admin users can access inactive)
+     *
+     * Endpoint: GET /businesses?active={boolean}&sanitize={mode}
+     * Auth: @ApiSecurity('projectKey') (enhanced with role-based filtering)
+     */
+    async getAllBusinesses(options) {
+        const params = new URLSearchParams();
+        if (options?.active !== undefined) {
+            params.append('active', String(options.active));
+        }
+        if (options?.sanitize) {
+            params.append('sanitize', options.sanitize);
+        }
+        const queryString = params.toString();
+        const url = queryString ? `${this.basePath}?${queryString}` : this.basePath;
+        return this.apiClient.get(url);
+    }
+    /**
+     * ADMIN: Get all businesses (admin endpoint with full access)
+     *
+     * Endpoint: GET /businesses/admin
+     * Auth: @TenantAdmin()
+     */
+    async getAllBusinessesAdmin(options) {
+        const params = new URLSearchParams();
+        if (options?.active !== undefined) {
+            params.append('active', String(options.active));
+        }
+        if (options?.sanitize) {
+            params.append('sanitize', options.sanitize);
+        }
+        const queryString = params.toString();
+        const url = queryString ? `${this.basePath}?${queryString}` : this.basePath;
+        return this.apiClient.get(url);
+    }
+    /**
+     * Get business by ID
+     *
+     * Endpoint: GET /businesses/{id}
+     * Auth: @ApiSecurity('projectKey')
+     */
+    async getBusinessById(businessId) {
+        return this.apiClient.get(`${this.basePath}/${businessId}`);
+    }
+    /**
+     * Get business by account address
+     *
+     * Endpoint: GET /businesses/account/{accountAddress}
+     * Auth: @ApiSecurity('projectKey')
+     */
+    async getBusinessByAccount(accountAddress) {
+        return this.apiClient.get(`${this.basePath}/account/${accountAddress}`);
+    }
+    // ==========================================
+    // 🔧 ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Create business
+     *
+     * Endpoint: POST /businesses
+     * Auth: @TenantAdmin()
+     * Returns: BusinessApiKeyDTO | BusinessTokenBalancesDTO
+     */
+    async createBusiness(dto) {
+        return this.apiClient.post(`${this.basePath}`, dto);
+    }
+    /**
+     * ADMIN: Create business by display name (convenience method)
+     *
+     * This is a convenience wrapper that creates the proper DTO structure
+     */
+    async createBusinessByDisplayName(displayName) {
+        const dto = {
+            displayName,
+            // Add other required fields based on BusinessCreateRequestDTO structure
+            // You may need to check the DTO definition for required fields
+        };
+        return this.createBusiness(dto);
+    }
+    /**
+     * ADMIN: Create businesses from URL
+     *
+     * Endpoint: POST /businesses/bulk/url
+     * Auth: @TenantAdmin()
+     */
+    async createBusinessesFromUrl(url) {
+        return this.apiClient.post(`${this.basePath}/bulk/url`, { url });
+    }
+    /**
+     * ADMIN: Update business
+     *
+     * Endpoint: PUT /businesses/{id}
+     * Auth: @TenantAdmin()
+     */
+    async updateBusiness(id, businessData) {
+        return this.apiClient.put(`${this.basePath}/${id}`, businessData);
+    }
+    /**
+     * ADMIN: Toggle business active status
+     *
+     * Endpoint: PUT /businesses/{id}/activate
+     * Auth: @TenantAdmin()
+     */
+    async toggleBusinessActive(id, isActive) {
+        const dto = { isActive };
+        return this.apiClient.put(`${this.basePath}/${id}/status`, dto);
+    }
+    /**
+     * ADMIN: Generate new business API key
+     *
+     * Endpoint: PUT /businesses/{id}/api-key
+     * Auth: @TenantAdmin()
+     */
+    async generateNewBusinessApiKey(id) {
+        return this.apiClient.put(`${this.basePath}/${id}/api-key`, {});
+    }
+}
+
+/**
+ * Platform-Agnostic Business Service
+ *
+ * Contains business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ */
+class BusinessService {
+    constructor(businessApi) {
+        this.businessApi = businessApi;
+    }
+    /**
+     * Get all active businesses
+     */
+    async getActiveBusinesses() {
+        return this.businessApi.getActiveBusinesses();
+    }
+    /**
+     * Get all business types
+     */
+    async getAllBusinessTypes() {
+        return this.businessApi.getAllBusinessTypes();
+    }
+    /**
+     * Get business by ID
+     */
+    async getBusinessById(businessId) {
+        return this.businessApi.getBusinessById(businessId);
+    }
+    /**
+     * Get business by account address
+     */
+    async getBusinessByAccount(accountAddress) {
+        return this.businessApi.getBusinessByAccount(accountAddress);
+    }
+    /**
+     * Get businesses by type (client-side filtering)
+     */
+    async getBusinessesByType(typeId) {
+        const businesses = await this.getActiveBusinesses();
+        return businesses.filter(business => business.businessType && business.businessType.id === parseInt(typeId));
+    }
+    // ==========================================
+    // ADMIN OPERATIONS
+    // ==========================================
+    /**
+     * ADMIN: Get all businesses (active and inactive)
+     */
+    async getAllBusinesses() {
+        return this.businessApi.getAllBusinesses();
+    }
+    /**
+     * ADMIN: Create business by display name
+     */
+    async createBusinessByDisplayName(displayName) {
+        return this.businessApi.createBusinessByDisplayName(displayName);
+    }
+    /**
+     * ADMIN: Update business
+     */
+    async updateBusiness(id, businessData) {
+        return this.businessApi.updateBusiness(id, businessData);
+    }
+    /**
+     * ADMIN: Toggle business active status
+     */
+    async toggleBusinessActive(id, isActive) {
+        return this.businessApi.toggleBusinessActive(id, isActive);
+    }
+}
+
+/**
+ * @explorins/pers-sdk-business
+ *
+ * Platform-agnostic Business Domain SDK for PERS ecosystem
+ * Focuses on non-admin business operations
+ */
+// API Layer
+/**
+ * Create a complete Business SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns Business SDK with flattened structure for better DX
+ */
+function createBusinessSDK(apiClient) {
+    const businessApi = new BusinessApi(apiClient);
+    const businessService = new BusinessService(businessApi);
+    return {
+        // Direct access to service methods (primary interface)
+        getActiveBusinesses: () => businessService.getActiveBusinesses(),
+        getAllBusinessTypes: () => businessService.getAllBusinessTypes(),
+        getBusinessById: (businessId) => businessService.getBusinessById(businessId),
+        getBusinessByAccount: (accountAddress) => businessService.getBusinessByAccount(accountAddress),
+        getBusinessesByType: (typeId) => businessService.getBusinessesByType(typeId),
+        // Admin methods
+        getAllBusinesses: () => businessService.getAllBusinesses(),
+        createBusinessByDisplayName: (displayName) => businessService.createBusinessByDisplayName(displayName),
+        updateBusiness: (id, businessData) => businessService.updateBusiness(id, businessData),
+        toggleBusinessActive: (id, isActive) => businessService.toggleBusinessActive(id, isActive),
+        // Advanced access for edge cases
+        api: businessApi,
+        service: businessService
+    };
+}
+
+exports.BusinessApi = BusinessApi;
+exports.BusinessService = BusinessService;
+exports.createBusinessSDK = createBusinessSDK;
+//# sourceMappingURL=business.cjs.map

package/dist/business.cjs.map

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