@flusys/nestjs-iam 6.0.2 → 6.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/cjs/controllers/action.controller.spec.js +79 -0
  2. package/cjs/controllers/company-action-permission.controller.js +1 -1
  3. package/cjs/controllers/company-action-permission.controller.spec.js +65 -0
  4. package/cjs/controllers/my-permission.controller.spec.js +56 -0
  5. package/cjs/controllers/role-permission.controller.spec.js +140 -0
  6. package/cjs/controllers/role.controller.spec.js +86 -0
  7. package/cjs/controllers/user-action-permission.controller.js +1 -1
  8. package/cjs/controllers/user-action-permission.controller.spec.js +68 -0
  9. package/cjs/docs/iam-swagger.config.spec.js +99 -0
  10. package/cjs/dtos/permission.dto.js +7 -0
  11. package/cjs/entities/index.spec.js +56 -0
  12. package/cjs/entities/permission-base.entity.js +1 -10
  13. package/cjs/entities/permission-with-company.entity.js +0 -3
  14. package/cjs/entities/user-iam-permission.entity.js +0 -3
  15. package/cjs/helpers/company-access.helper.spec.js +68 -0
  16. package/cjs/helpers/permission-mode.helper.spec.js +54 -0
  17. package/cjs/modules/iam.module.js +2 -2
  18. package/cjs/modules/iam.module.spec.js +293 -0
  19. package/cjs/services/action.service.js +4 -4
  20. package/cjs/services/action.service.spec.js +314 -0
  21. package/cjs/services/iam-config.service.spec.js +110 -0
  22. package/cjs/services/iam-datasource.service.spec.js +117 -0
  23. package/cjs/services/permission-cache.service.js +363 -52
  24. package/cjs/services/permission-cache.service.spec.js +699 -0
  25. package/cjs/services/permission.service.js +92 -396
  26. package/cjs/services/permission.service.spec.js +692 -0
  27. package/cjs/services/role.service.js +1 -1
  28. package/cjs/services/role.service.spec.js +309 -0
  29. package/dtos/permission.dto.d.ts +1 -0
  30. package/entities/permission-base.entity.d.ts +0 -1
  31. package/fesm/controllers/action.controller.spec.js +75 -0
  32. package/fesm/controllers/company-action-permission.controller.js +1 -1
  33. package/fesm/controllers/company-action-permission.controller.spec.js +61 -0
  34. package/fesm/controllers/my-permission.controller.spec.js +52 -0
  35. package/fesm/controllers/role-permission.controller.spec.js +136 -0
  36. package/fesm/controllers/role.controller.spec.js +82 -0
  37. package/fesm/controllers/user-action-permission.controller.js +1 -1
  38. package/fesm/controllers/user-action-permission.controller.spec.js +64 -0
  39. package/fesm/docs/iam-swagger.config.spec.js +95 -0
  40. package/fesm/dtos/permission.dto.js +7 -0
  41. package/fesm/entities/index.spec.js +52 -0
  42. package/fesm/entities/permission-base.entity.js +1 -10
  43. package/fesm/entities/permission-with-company.entity.js +0 -3
  44. package/fesm/entities/user-iam-permission.entity.js +0 -3
  45. package/fesm/helpers/company-access.helper.spec.js +64 -0
  46. package/fesm/helpers/permission-mode.helper.spec.js +50 -0
  47. package/fesm/modules/iam.module.js +4 -4
  48. package/fesm/modules/iam.module.spec.js +289 -0
  49. package/fesm/services/action.service.js +4 -4
  50. package/fesm/services/action.service.spec.js +310 -0
  51. package/fesm/services/iam-config.service.spec.js +106 -0
  52. package/fesm/services/iam-datasource.service.spec.js +113 -0
  53. package/fesm/services/permission-cache.service.js +365 -51
  54. package/fesm/services/permission-cache.service.spec.js +695 -0
  55. package/fesm/services/permission.service.js +92 -396
  56. package/fesm/services/permission.service.spec.js +688 -0
  57. package/fesm/services/role.service.js +1 -1
  58. package/fesm/services/role.service.spec.js +305 -0
  59. package/package.json +3 -3
  60. package/services/permission-cache.service.d.ts +20 -3
  61. package/services/permission.service.d.ts +2 -16
@@ -0,0 +1,106 @@
1
+ import { IAMPermissionMode } from '../enums/permission-type.enum';
2
+ import { IAMConfigService } from './iam-config.service';
3
+ describe('IAMConfigService', ()=>{
4
+ describe('with no injected options (defaults)', ()=>{
5
+ let service;
6
+ beforeEach(()=>{
7
+ service = new IAMConfigService();
8
+ });
9
+ it('defaults to single database mode', ()=>{
10
+ expect(service.getDatabaseMode()).toBe('single');
11
+ expect(service.isMultiTenant()).toBe(false);
12
+ });
13
+ it('defaults company feature to disabled', ()=>{
14
+ expect(service.isCompanyFeatureEnabled()).toBe(false);
15
+ });
16
+ it('defaults permission mode to FULL', ()=>{
17
+ expect(service.getPermissionMode()).toBe(IAMPermissionMode.FULL);
18
+ expect(service.isRbacEnabled()).toBe(true);
19
+ expect(service.isDirectPermissionEnabled()).toBe(true);
20
+ });
21
+ it('returns the fallback options object from getOptions', ()=>{
22
+ expect(service.getOptions()).toEqual({
23
+ global: false,
24
+ includeController: false
25
+ });
26
+ });
27
+ });
28
+ describe('with injected options', ()=>{
29
+ function buildService(overrides) {
30
+ const options = {
31
+ global: false,
32
+ includeController: false,
33
+ bootstrapAppConfig: {
34
+ databaseMode: 'single',
35
+ enableCompanyFeature: false,
36
+ ...overrides
37
+ }
38
+ };
39
+ return new IAMConfigService(options);
40
+ }
41
+ it('reports multi-tenant mode when configured', ()=>{
42
+ const service = buildService({
43
+ databaseMode: 'multi-tenant'
44
+ });
45
+ expect(service.getDatabaseMode()).toBe('multi-tenant');
46
+ expect(service.isMultiTenant()).toBe(true);
47
+ });
48
+ it('reports company feature enabled when configured', ()=>{
49
+ const service = buildService({
50
+ enableCompanyFeature: true
51
+ });
52
+ expect(service.isCompanyFeatureEnabled()).toBe(true);
53
+ });
54
+ describe('permission mode: RBAC', ()=>{
55
+ let service;
56
+ beforeEach(()=>{
57
+ service = buildService({
58
+ permissionMode: 'RBAC'
59
+ });
60
+ });
61
+ it('enables RBAC but not direct permissions', ()=>{
62
+ expect(service.getPermissionMode()).toBe(IAMPermissionMode.RBAC);
63
+ expect(service.isRbacEnabled()).toBe(true);
64
+ expect(service.isDirectPermissionEnabled()).toBe(false);
65
+ });
66
+ });
67
+ describe('permission mode: DIRECT', ()=>{
68
+ let service;
69
+ beforeEach(()=>{
70
+ service = buildService({
71
+ permissionMode: 'DIRECT'
72
+ });
73
+ });
74
+ it('enables direct permissions but not RBAC', ()=>{
75
+ expect(service.getPermissionMode()).toBe(IAMPermissionMode.DIRECT);
76
+ expect(service.isRbacEnabled()).toBe(false);
77
+ expect(service.isDirectPermissionEnabled()).toBe(true);
78
+ });
79
+ });
80
+ describe('permission mode: FULL', ()=>{
81
+ let service;
82
+ beforeEach(()=>{
83
+ service = buildService({
84
+ permissionMode: 'FULL'
85
+ });
86
+ });
87
+ it('enables both RBAC and direct permissions', ()=>{
88
+ expect(service.getPermissionMode()).toBe(IAMPermissionMode.FULL);
89
+ expect(service.isRbacEnabled()).toBe(true);
90
+ expect(service.isDirectPermissionEnabled()).toBe(true);
91
+ });
92
+ });
93
+ it('returns the exact injected options object from getOptions', ()=>{
94
+ const options = {
95
+ global: true,
96
+ includeController: true,
97
+ bootstrapAppConfig: {
98
+ databaseMode: 'single',
99
+ enableCompanyFeature: true
100
+ }
101
+ };
102
+ const service = new IAMConfigService(options);
103
+ expect(service.getOptions()).toBe(options);
104
+ });
105
+ });
106
+ });
@@ -0,0 +1,113 @@
1
+ import { MultiTenantDataSourceService } from '@flusys/nestjs-shared/modules';
2
+ import { Action } from '../entities/action.entity';
3
+ import { UserIamPermission } from '../entities/user-iam-permission.entity';
4
+ import { UserIamPermissionWithCompany } from '../entities/permission-with-company.entity';
5
+ import { Role } from '../entities/role.entity';
6
+ import { RoleWithCompany } from '../entities/role-with-company.entity';
7
+ import { IAMDataSourceService } from './iam-datasource.service';
8
+ describe('IAMDataSourceService', ()=>{
9
+ let mockConfigService;
10
+ beforeEach(()=>{
11
+ mockConfigService = {
12
+ isCompanyFeatureEnabled: jest.fn().mockReturnValue(false),
13
+ getPermissionMode: jest.fn(),
14
+ getOptions: jest.fn().mockReturnValue({
15
+ global: false,
16
+ includeController: false
17
+ })
18
+ };
19
+ });
20
+ function buildService(request) {
21
+ return new IAMDataSourceService(mockConfigService, request);
22
+ }
23
+ describe('getEnableCompanyFeatureForTenant', ()=>{
24
+ it('uses the tenant override when defined (true)', ()=>{
25
+ const service = buildService();
26
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(false);
27
+ expect(service.getEnableCompanyFeatureForTenant({
28
+ enableCompanyFeature: true
29
+ })).toBe(true);
30
+ });
31
+ it('uses the tenant override when defined (false)', ()=>{
32
+ const service = buildService();
33
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(true);
34
+ expect(service.getEnableCompanyFeatureForTenant({
35
+ enableCompanyFeature: false
36
+ })).toBe(false);
37
+ });
38
+ it('falls back to the config service when the tenant has no override', ()=>{
39
+ const service = buildService();
40
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(true);
41
+ expect(service.getEnableCompanyFeatureForTenant({})).toBe(true);
42
+ });
43
+ it('falls back to the config service when no tenant is provided', ()=>{
44
+ const service = buildService();
45
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(true);
46
+ expect(service.getEnableCompanyFeatureForTenant(undefined)).toBe(true);
47
+ });
48
+ });
49
+ describe('getEnableCompanyFeatureForCurrentTenant', ()=>{
50
+ it('falls back to the config service when there is no current request/tenant', ()=>{
51
+ const service = buildService();
52
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(true);
53
+ expect(service.getEnableCompanyFeatureForCurrentTenant()).toBe(true);
54
+ });
55
+ });
56
+ describe('getIAMEntities', ()=>{
57
+ it('returns Action + non-company permission + role entities for RBAC mode', async ()=>{
58
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(false);
59
+ mockConfigService.getPermissionMode.mockReturnValue(1); // RBAC
60
+ const service = buildService();
61
+ const entities = await service.getIAMEntities();
62
+ expect(entities).toContain(Action);
63
+ expect(entities).toContain(UserIamPermission);
64
+ expect(entities).toContain(Role);
65
+ expect(entities).not.toContain(UserIamPermissionWithCompany);
66
+ expect(entities).not.toContain(RoleWithCompany);
67
+ });
68
+ it('returns company-scoped entities when company feature is enabled', async ()=>{
69
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(true);
70
+ mockConfigService.getPermissionMode.mockReturnValue(3); // FULL
71
+ const service = buildService();
72
+ const entities = await service.getIAMEntities();
73
+ expect(entities).toContain(Action);
74
+ expect(entities).toContain(UserIamPermissionWithCompany);
75
+ expect(entities).toContain(RoleWithCompany);
76
+ expect(entities).not.toContain(UserIamPermission);
77
+ expect(entities).not.toContain(Role);
78
+ });
79
+ it('excludes role entities entirely in DIRECT mode', async ()=>{
80
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(false);
81
+ mockConfigService.getPermissionMode.mockReturnValue(2); // DIRECT
82
+ const service = buildService();
83
+ const entities = await service.getIAMEntities();
84
+ expect(entities).toEqual([
85
+ Action,
86
+ UserIamPermission
87
+ ]);
88
+ });
89
+ });
90
+ describe('createDataSourceFromConfig', ()=>{
91
+ it('resolves IAM entities and delegates to the parent with them', async ()=>{
92
+ mockConfigService.isCompanyFeatureEnabled.mockReturnValue(false);
93
+ mockConfigService.getPermissionMode.mockReturnValue(1); // RBAC
94
+ const service = buildService();
95
+ const fakeDataSource = {
96
+ isInitialized: true
97
+ };
98
+ const parentSpy = jest.spyOn(MultiTenantDataSourceService.prototype, 'createDataSourceFromConfig').mockResolvedValue(fakeDataSource);
99
+ const config = {
100
+ type: 'mysql',
101
+ host: 'localhost'
102
+ };
103
+ const result = await service.createDataSourceFromConfig(config);
104
+ expect(result).toBe(fakeDataSource);
105
+ expect(parentSpy).toHaveBeenCalledWith(config, [
106
+ Action,
107
+ UserIamPermission,
108
+ Role
109
+ ]);
110
+ parentSpy.mockRestore();
111
+ });
112
+ });
113
+ });