fix: API improvements aligning the types to our schemas (#4650)

Some of our types in OSS have drifted apart from our OpenAPI schemas.
This will help them be aligned again

src/lib/db/access-store.ts

@@ -20,6 +20,7 @@ import {
     ROOT_PERMISSION_TYPE,
 } from '../util/constants';
 import { Db } from './db';
+import { IdPermissionRef } from 'lib/services/access-service';
 
 const T = {
     ROLE_USER: 'role_user',
@@ -221,7 +222,7 @@ export class AccessStore implements IAccessStore {
 
     async addEnvironmentPermissionsToRole(
         role_id: number,
-        permissions: IPermission[],
+        permissions: IdPermissionRef[],
     ): Promise<void> {
         const rows = permissions.map((permission) => {
             return {

src/lib/openapi/spec/create-strategy-schema.ts

@@ -12,12 +12,29 @@ export const createStrategySchema = {
             description: 'The name of the strategy type. Must be unique.',
             example: 'my-custom-strategy',
         },
+        title: {
+            type: 'string',
+            description: 'The title of the strategy',
+            example: 'My awesome strategy',
+        },
         description: {
             type: 'string',
             description: 'A description of the strategy type.',
             example:
                 'Enable the feature for users who have not logged in before.',
         },
+        editable: {
+            type: 'boolean',
+            description:
+                'Whether the strategy type is editable or not. Defaults to `true`.',
+            example: false,
+        },
+        deprecated: {
+            type: 'boolean',
+            description:
+                'Whether the strategy type is deprecated or not. Defaults to `false`.',
+            example: true,
+        },
         parameters: {
             type: 'array',
             description:

src/lib/routes/admin-api/strategy.ts

@@ -238,7 +238,7 @@ class StrategyController extends Controller {
     }
 
     async createStrategy(
-        req: IAuthRequest<unknown, CreateStrategySchema>,
+        req: IAuthRequest<unknown, unknown, CreateStrategySchema>,
         res: Response<StrategySchema>,
     ): Promise<void> {
         const userName = extractUsername(req);

src/lib/services/access-service.ts

@@ -52,17 +52,22 @@ const PROJECT_ADMIN = [
     permissions.DELETE_FEATURE,
 ];
 
+/** @deprecated prefer to use NamePermissionRef */
+export type IdPermissionRef = Pick<IPermission, 'id' | 'environment'>;
+export type NamePermissionRef = Pick<IPermission, 'name' | 'environment'>;
+export type PermissionRef = IdPermissionRef | NamePermissionRef;
+
 interface IRoleCreation {
     name: string;
     description: string;
     type?: 'root-custom' | 'custom';
-    permissions?: IPermission[];
+    permissions?: PermissionRef[];
 }
 
 export interface IRoleValidation {
     name: string;
     description?: string;
-    permissions?: Pick<IPermission, 'id' | 'environment'>[];
+    permissions?: PermissionRef[];
 }
 
 interface IRoleUpdate {
@@ -70,7 +75,7 @@ interface IRoleUpdate {
     name: string;
     description: string;
     type?: 'root-custom' | 'custom';
-    permissions?: IPermission[];
+    permissions?: PermissionRef[];
 }
 
 export interface AccessWithRoles {
@@ -627,7 +632,7 @@ export class AccessService {
             if (roleType === CUSTOM_ROOT_ROLE_TYPE) {
                 await this.store.addPermissionsToRole(
                     newRole.id,
-                    rolePermissions.map(({ name }) => name),
+                    rolePermissions.map((p: NamePermissionRef) => p.name),
                 );
             } else {
                 await this.store.addEnvironmentPermissionsToRole(
@@ -668,7 +673,7 @@ export class AccessService {
             if (roleType === CUSTOM_ROOT_ROLE_TYPE) {
                 await this.store.addPermissionsToRole(
                     newRole.id,
-                    rolePermissions.map(({ name }) => name),
+                    rolePermissions.map((p: NamePermissionRef) => p.name),
                 );
             } else {
                 await this.store.addEnvironmentPermissionsToRole(

src/lib/services/project-service.ts

@@ -39,6 +39,7 @@ import {
     IProjectRoleUsage,
     ProjectAccessUserRolesDeleted,
     IFeatureNaming,
+    CreateProject,
 } from '../types';
 import { IProjectQuery, IProjectStore } from '../types/stores/project-store';
 import {
@@ -190,10 +191,7 @@ export default class ProjectService {
     };
 
     async createProject(
-        newProject: Pick<
+        newProject: CreateProject,
-            IProject,
-            'id' | 'name' | 'mode' | 'defaultStickiness'
-        >,
         user: IUser,
     ): Promise<IProject> {
         const data = await projectSchema.validateAsync(newProject);

src/lib/services/state-service.test.ts

@@ -320,6 +320,7 @@ test('should export strategies', async () => {
     await stores.strategyStore.createStrategy({
         name: 'a-strategy',
         editable: true,
+        parameters: [],
     });
 
     const data = await stateService.export({ includeStrategies: true });
@@ -595,7 +596,10 @@ test('exporting to new format works', async () => {
     await stores.featureToggleStore.create('fancy', {
         name: 'Some-feature',
     });
-    await stores.strategyStore.createStrategy({ name: 'format' });
+    await stores.strategyStore.createStrategy({
+        name: 'format',
+        parameters: [],
+    });
     await stores.featureEnvironmentStore.addEnvironmentToFeature(
         'Some-feature',
         'dev',
@@ -650,7 +654,10 @@ test('featureStrategies can keep existing', async () => {
     await stores.featureToggleStore.create('fancy', {
         name: 'Some-feature',
     });
-    await stores.strategyStore.createStrategy({ name: 'format' });
+    await stores.strategyStore.createStrategy({
+        name: 'format',
+        parameters: [],
+    });
     await stores.featureEnvironmentStore.addEnvironmentToFeature(
         'Some-feature',
         'dev',
@@ -697,7 +704,10 @@ test('featureStrategies should not keep existing if dropBeforeImport', async ()
     await stores.featureToggleStore.create('fancy', {
         name: 'Some-feature',
     });
-    await stores.strategyStore.createStrategy({ name: 'format' });
+    await stores.strategyStore.createStrategy({
+        name: 'format',
+        parameters: [],
+    });
     await stores.featureEnvironmentStore.addEnvironmentToFeature(
         'Some-feature',
         'dev',

src/lib/services/version-service.test.ts

@@ -163,6 +163,7 @@ test('counts toggles', async () => {
     await stores.strategyStore.createStrategy({
         name: uuidv4(),
         editable: true,
+        parameters: [],
     });
     const latest = {
         oss: '4.0.0',
@@ -213,10 +214,12 @@ test('counts custom strategies', async () => {
     await stores.strategyStore.createStrategy({
         name: strategyName,
         editable: true,
+        parameters: [],
     });
     await stores.strategyStore.createStrategy({
         name: uuidv4(),
         editable: true,
+        parameters: [],
     });
     await stores.featureStrategiesStore.createStrategyFeatureEnv({
         featureName: toggleName,

src/lib/types/model.ts

@@ -402,6 +402,14 @@ export interface IImportData extends ImportCommon {
     data: any;
 }
 
+// Create project aligns with #/components/schemas/createProjectSchema
+// joi is providing default values when the optional inputs are not provided
+// const data = await projectSchema.validateAsync(newProject);
+export type CreateProject = Pick<IProject, 'id' | 'name'> & {
+    mode?: ProjectMode;
+    defaultStickiness?: string;
+};
+
 export interface IProject {
     id: string;
     name: string;

src/lib/types/stores/access-store.ts

@@ -1,3 +1,4 @@
+import { PermissionRef } from 'lib/services/access-service';
 import { IGroupModelWithProjectRole } from '../group';
 import { IPermission, IUserWithRole } from '../model';
 import { Store } from './store';
@@ -100,7 +101,7 @@ export interface IAccessStore extends Store<IRole, number> {
 
     addEnvironmentPermissionsToRole(
         role_id: number,
-        permissions: IPermission[],
+        permissions: PermissionRef[],
     ): Promise<void>;
 
     addUserToRole(

src/lib/types/stores/strategy-store.ts

@@ -1,3 +1,4 @@
+import { CreateStrategySchema } from 'lib/openapi';
 import { Store } from './store';
 
 export interface IStrategy {
@@ -18,24 +19,22 @@ export interface IEditableStrategy {
     title?: string;
 }
 
-export interface IMinimalStrategy {
+export type IMinimalStrategy = Pick<
-    name: string;
+    CreateStrategySchema,
-    description?: string;
+    'name' | 'description' | 'editable' | 'parameters' | 'title'
-    editable?: boolean;
+>;
-    parameters?: any[];
-    title?: string;
-}
 
-export interface IStrategyImport {
+export type IStrategyImport = Pick<
-    name: string;
+    CreateStrategySchema,
-    description?: string;
+    | 'name'
-    deprecated?: boolean;
+    | 'description'
-    parameters?: object[];
+    | 'deprecated'
-    builtIn?: boolean;
+    | 'parameters'
-    sortOrder?: number;
+    | 'builtIn'
-    displayName?: string;
+    | 'sortOrder'
-    title?: string;
+    | 'displayName'
-}
+    | 'title'
+>;
 
 export interface IMinimalStrategyRow {
     name: string;

src/test/e2e/services/project-service.e2e.test.ts

@@ -801,18 +801,10 @@ test('should add a user to the project with a custom role', async () => {
         description: '',
         permissions: [
             {
-                id: 2,
+                id: 2, // CREATE_FEATURE
-                name: 'CREATE_FEATURE',
-                environment: undefined,
-                displayName: 'Create Feature Toggles',
-                type: 'project',
             },
             {
-                id: 8,
+                id: 8, // DELETE_FEATURE
-                name: 'DELETE_FEATURE',
-                environment: undefined,
-                displayName: 'Delete Feature Toggles',
-                type: 'project',
             },
         ],
     });
@@ -859,18 +851,10 @@ test('should delete role entries when deleting project', async () => {
         description: '',
         permissions: [
             {
-                id: 2,
+                id: 2, // CREATE_FEATURE
-                name: 'CREATE_FEATURE',
-                environment: undefined,
-                displayName: 'Create Feature Toggles',
-                type: 'project',
             },
             {
-                id: 8,
+                id: 8, // DELETE_FEATURE
-                name: 'DELETE_FEATURE',
-                environment: undefined,
-                displayName: 'Delete Feature Toggles',
-                type: 'project',
             },
         ],
     });
@@ -907,18 +891,10 @@ test('should change a users role in the project', async () => {
         description: '',
         permissions: [
             {
-                id: 2,
+                id: 2, // CREATE_FEATURE
-                name: 'CREATE_FEATURE',
-                environment: undefined,
-                displayName: 'Create Feature Toggles',
-                type: 'project',
             },
             {
-                id: 8,
+                id: 8, // DELETE_FEATURE
-                name: 'DELETE_FEATURE',
-                environment: undefined,
-                displayName: 'Delete Feature Toggles',
-                type: 'project',
             },
         ],
     });
@@ -1098,11 +1074,7 @@ test('Should allow bulk update of group permissions', async () => {
         description: '',
         permissions: [
             {
-                id: 2,
+                id: 2, // CREATE_FEATURE
-                name: 'CREATE_FEATURE',
-                environment: undefined,
-                displayName: 'Create Feature Toggles',
-                type: 'project',
             },
         ],
     });
@@ -1129,11 +1101,7 @@ test('Should bulk update of only users', async () => {
         description: '',
         permissions: [
             {
-                id: 2,
+                id: 2, // CREATE_FEATURE
-                name: 'CREATE_FEATURE',
-                environment: undefined,
-                displayName: 'Create Feature Toggles',
-                type: 'project',
             },
         ],
     });
@@ -1168,11 +1136,7 @@ test('Should allow bulk update of only groups', async () => {
         description: '',
         permissions: [
             {
-                id: 2,
+                id: 2, // CREATE_FEATURE
-                name: 'CREATE_FEATURE',
-                environment: undefined,
-                displayName: 'Create Feature Toggles',
-                type: 'project',
             },
         ],
     });
@@ -1221,10 +1185,7 @@ test('Should allow permutations of roles, groups and users when adding a new acc
         description: '',
         permissions: [
             {
-                id: 2,
+                id: 2, // CREATE_FEATURE
-                name: 'CREATE_FEATURE',
-                displayName: 'Create feature toggles',
-                type: 'project',
             },
         ],
     });
@@ -1234,10 +1195,7 @@ test('Should allow permutations of roles, groups and users when adding a new acc
         description: '',
         permissions: [
             {
-                id: 7,
+                id: 7, // UPDATE_FEATURE
-                name: 'UPDATE_FEATURE',
-                displayName: 'Update feature toggles',
-                type: 'project',
             },
         ],
     });

src/test/fixtures/fake-access-store.ts

@@ -12,6 +12,7 @@ import {
 import { IPermission } from 'lib/types/model';
 import { IRoleStore } from 'lib/types';
 import FakeRoleStore from './fake-role-store';
+import { PermissionRef } from 'lib/services/access-service';
 
 class AccessStoreMock implements IAccessStore {
     fakeRolesStore: IRoleStore;
@@ -118,7 +119,7 @@ class AccessStoreMock implements IAccessStore {
 
     addEnvironmentPermissionsToRole(
         role_id: number,
-        permissions: IPermission[],
+        permissions: PermissionRef[],
     ): Promise<void> {
         return Promise.resolve(undefined);
     }