Modify based on review comments.

Make it breaking change.

Signed-off-by: Jussi Hallila <jussi@hallila.com>

plugins/tech-insights-backend/README.md

@@ -91,10 +91,10 @@ const myFactRetrieverRegistration = createFactRetrieverRegistration(
 );
 ```
 
-FactRetrieverRegistration also accepts an optional `lifecycle` configuration value. This can be either ITL (items to live) or TTL (time to live). Valid options for this value are either a number for ITL or a Luxon duration like object for TTL. For example:
+FactRetrieverRegistration also accepts an optional `lifecycle` configuration value. This can be either MaxItems or TTL (time to live). Valid options for this value are either a number for MaxItems or a Luxon duration like object for TTL. For example:
 
 ```ts
-const itl = { itl: 7 }; // Deletes all but 7 latest facts for each id/entity pair
+const maxItems = { maxItems: 7 }; // Deletes all but 7 latest facts for each id/entity pair
 const ttl = { ttl: 1209600000 }; // (2 weeks) Deletes items older than 2 weeks
 const ttlWithAHumanReadableValue = { ttl: { weeks: 2 } }; // Deletes items older than 2 weeks
 ```

plugins/tech-insights-backend/src/service/fact/createFactRetriever.ts

@@ -19,6 +19,12 @@ import {
   FactRetrieverRegistration,
 } from '@backstage/plugin-tech-insights-node';
 
+export type FactRetrieverRegistrationOptions = {
+  cadence: string;
+  factRetriever: FactRetriever;
+  lifecycle?: FactLifecycle;
+};
+
 /**
  * @public
  *
@@ -47,11 +53,11 @@ import {
  * \{ itl: 7 \} -- This fact retriever will leave 7 newest items in the database when it is run
  *
  */
-export function createFactRetrieverRegistration(
-  cadence: string,
-  factRetriever: FactRetriever,
-  lifecycle?: FactLifecycle,
-): FactRetrieverRegistration {
+export function createFactRetrieverRegistration({
+  cadence,
+  factRetriever,
+  lifecycle,
+}: FactRetrieverRegistrationOptions): FactRetrieverRegistration {
   return {
     cadence,
     factRetriever,

plugins/tech-insights-backend/src/service/fact/factRetrievers/utils.ts

@@ -16,7 +16,11 @@
 import camelCase from 'lodash/camelCase';
 import { Entity } from '@backstage/catalog-model';
 import { get } from 'lodash';
-import { FactLifecycle, ITL, TTL } from '@backstage/plugin-tech-insights-node';
+import {
+  FactLifecycle,
+  MaxItems,
+  TTL,
+} from '@backstage/plugin-tech-insights-node';
 
 export const generateAnnotationFactName = (annotation: string) =>
   camelCase(`hasAnnotation-${annotation}`);
@@ -25,9 +29,9 @@ export const entityHasAnnotation = (entity: Entity, annotation: string) =>
   Boolean(get(entity, ['metadata', 'annotations', annotation]));
 
 export const isTtl = (lifecycle: FactLifecycle): lifecycle is TTL => {
-  return !!(lifecycle as TTL).ttl;
+  return !!(lifecycle as TTL).timeToLive;
 };
 
-export const isItl = (lifecycle: FactLifecycle): lifecycle is ITL => {
-  return !!(lifecycle as ITL).itl;
+export const isMaxItems = (lifecycle: FactLifecycle): lifecycle is MaxItems => {
+  return !!(lifecycle as MaxItems).maxItems;
 };

plugins/tech-insights-backend/src/service/persistence/TechInsightsDatabase.test.ts

@@ -265,7 +265,7 @@ describe('Tech Insights database', () => {
     });
   });
 
-  it('should delete extraneous rows when ITL is defined. Should leave only n latest', async () => {
+  it('should delete extraneous rows when MaxItems is defined. Should leave only n latest', async () => {
     const deviledFact = (it: {}) => ({
       ...it,
       facts: JSON.stringify({
@@ -289,11 +289,11 @@ describe('Tech Insights database', () => {
         testNumberFact: 555,
       },
     };
-    const itl = 2;
-    await store.insertFacts('test-fact', [factToBeInserted], { itl });
+    const maxItems = 2;
+    await store.insertFacts('test-fact', [factToBeInserted], { maxItems });
 
     const afterInsertionFacts = await testDbClient('facts').select();
-    expect(afterInsertionFacts).toHaveLength(itl);
+    expect(afterInsertionFacts).toHaveLength(maxItems);
     expect(afterInsertionFacts[0]).toMatchObject(
       deviledFact(additionalFacts[0]),
     );
@@ -335,7 +335,7 @@ describe('Tech Insights database', () => {
       },
     };
     await store.insertFacts('test-fact', [factToBeInserted], {
-      ttl: { weeks: 2 },
+      timeToLive: { weeks: 2 },
     });
 
     const afterInsertionFacts = await testDbClient('facts')

plugins/tech-insights-backend/src/service/persistence/TechInsightsDatabase.ts

@@ -27,7 +27,7 @@ import { groupBy, omit } from 'lodash';
 import { DateTime } from 'luxon';
 import { Logger } from 'winston';
 import { parseEntityName, stringifyEntityRef } from '@backstage/catalog-model';
-import { isItl, isTtl } from '../fact/factRetrievers/utils';
+import { isMaxItems, isTtl } from '../fact/factRetrievers/utils';
 import Transaction = Knex.Transaction;
 
 export type RawDbFactRow = {
@@ -108,12 +108,11 @@ export class TechInsightsDatabase implements TechInsightsStore {
       await tx.batchInsert<RawDbFactRow>('facts', factRows, this.CHUNK_SIZE);
 
       if (lifecycle && isTtl(lifecycle)) {
-        const expiration = DateTime.now().minus(lifecycle.ttl);
+        const expiration = DateTime.now().minus(lifecycle.timeToLive);
         await this.deleteExpiredFactsByDate(tx, factRows, expiration);
       }
-      if (lifecycle && isItl(lifecycle)) {
-        const items = lifecycle.itl;
-        await this.deleteExpiredFactsByNumber(tx, factRows, items);
+      if (lifecycle && isMaxItems(lifecycle)) {
+        await this.deleteExpiredFactsByNumber(tx, factRows, lifecycle.maxItems);
       }
     });
   }
@@ -204,7 +203,7 @@ export class TechInsightsDatabase implements TechInsightsStore {
   private async deleteExpiredFactsByNumber(
     tx: Transaction,
     factRows: { id: string; entity: string }[],
-    items: number,
+    maxItems: number,
   ) {
     const deletables = await tx<RawDbFactRow>('facts')
       .whereIn(
@@ -220,7 +219,7 @@ export class TechInsightsDatabase implements TechInsightsStore {
                            row_number() over (partition by id, entity order by timestamp desc) as fact_rank
                        from facts) ranks
                  where fact_rank <= ?? ) as filterjoin`,
-          items,
+          maxItems,
         ),
         joinClause => {
           joinClause