CCM-13146 simple ttl insertion and deletion

Author: Ian-Hodges

.gitleaksignore

@@ -12,3 +12,7 @@ cd9c0efec38c5d63053dd865e5d4e207c0760d91:docs/guides/Perform_static_analysis.md:
 973c8a1feb76f3cd8743ce27b14e4acc4252240c:src/TESTING_PLAN.md:ipv4:2507
 cc74128e4207833109339e96f3aaebf3cd40dd65:src/TESTING_PLAN.md:ipv4:2507
 791619daf5af4806da7266fa301c0e82145b6de8:src/TESTING_PLAN.md:ipv4:2507
+f8546e35b77b69ba7b15dbe3174d2d7e375200ef:utils/utils/src/__tests__/key-generation/validate-private-key.test.ts:private-key:7
+f8546e35b77b69ba7b15dbe3174d2d7e375200ef:utils/utils/src/__tests__/key-generation/get-private-key.test.ts:private-key:23
+f8546e35b77b69ba7b15dbe3174d2d7e375200ef:utils/utils/src/__tests__/key-generation/get-private-key.test.ts:private-key:30
+f8546e35b77b69ba7b15dbe3174d2d7e375200ef:utils/utils/src/__tests__/key-generation/get-private-key.test.ts:private-key:46

tests/playwright/digital-letters-component-tests/create-ttl.component.spec.ts

@@ -1,5 +1,5 @@
 import { expect, test } from '@playwright/test';
-import getTtl from 'helpers/dynamodb-helpers';
+import { getTtl } from 'helpers/dynamodb-helpers';
 import eventPublisher from 'helpers/event-bus-helpers';
 import expectToPassEventually from 'helpers/expectations';
 import { v4 as uuidv4 } from 'uuid';

tests/playwright/digital-letters-component-tests/handle-ttl.component.spec.ts

@@ -0,0 +1,64 @@
+import { expect, test } from '@playwright/test';
+import { deleteTtl, putTtl } from 'helpers/dynamodb-helpers';
+import expectToPassEventually from 'helpers/expectations';
+import { v4 as uuidv4 } from 'uuid';
+
+test.describe('Digital Letters - Handle TTL', () => {
+  const baseEvent = {
+    profileversion: '1.0.0',
+    profilepublished: '2025-10',
+    specversion: '1.0',
+    source:
+      '/nhs/england/notify/production/primary/data-plane/digital-letters',
+    subject:
+      'customer/920fca11-596a-4eca-9c47-99f624614658/recipient/769acdd4-6a47-496f-999f-76a6fd2c3959',
+    type: 'uk.nhs.notify.digital.letters.mesh.inbox.message.downloaded.v1',
+    time: '2023-06-20T12:00:00Z',
+    recordedtime: '2023-06-20T12:00:00.250Z',
+    severitynumber: 2,
+    traceparent: '00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01',
+    datacontenttype: 'application/json',
+    dataschema:
+      'https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10/digital-letter-base-data.schema.json',
+    dataschemaversion: '1.0',
+    severitytext: 'INFO',
+    data: {
+      messageReference: 'ref1',
+      senderId: 'sender1',
+    },
+  }
+
+
+  test('should handle withdrawn item', async () => {
+    const letterId = uuidv4();
+    const messageUri = `https://example.com/ttl/resource/${letterId}`;
+
+    const event = {
+      ...baseEvent,
+      id: letterId,
+      data: {
+        ...baseEvent.data,
+        messageUri,
+        'digital-letter-id': letterId,
+      }
+    }
+
+    const ttlItem = {
+      PK: messageUri,
+      SK: 'TTL',
+      dateOfExpiry: '2023-12-31#0',
+      event,
+      ttl: (Date.now() / 1000) + 3600,
+      withdrawn: true,
+    }
+
+
+    await expectToPassEventually(async () => {
+      const putResponseCode = await putTtl(ttlItem);
+      expect(putResponseCode).toBe(201);
+
+      const deleteResponseCode = await deleteTtl(messageUri);
+      expect(deleteResponseCode).toBe(200);
+    });
+  });
+});

tests/playwright/helpers/dynamodb-helpers.ts

@@ -1,10 +1,12 @@
-import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DeleteItemCommand, DeleteItemCommandOutput, DynamoDBClient, PutItemCommand, PutItemCommandOutput } from '@aws-sdk/client-dynamodb';
 import { QueryCommand, QueryCommandOutput } from '@aws-sdk/lib-dynamodb';
+import { marshall } from '@aws-sdk/util-dynamodb';
 import { REGION, TTL_TABLE_NAME } from 'constants/backend-constants';
+import { TtlDynamodbRecord } from 'utils';
 
 const dynamoDbClient = new DynamoDBClient({ region: REGION });
 
-async function getTtl(messageUri: string) {
+export async function getTtl(messageUri: string) {
   const params = {
     TableName: TTL_TABLE_NAME,
     KeyConditionExpression: `PK = :messageUri`,
@@ -18,4 +20,31 @@ async function getTtl(messageUri: string) {
   return Items ?? [];
 }
 
-export default getTtl;
+export async function putTtl(ttlItem: TtlDynamodbRecord) {
+  const params = {
+    TableName: TTL_TABLE_NAME,
+    Item: marshall(ttlItem),
+  };
+  const request = new PutItemCommand(params);
+  const output: PutItemCommandOutput = await dynamoDbClient.send(request);
+
+  return output.$metadata.httpStatusCode;
+}
+
+export async function deleteTtl(messageUri: string) {
+  const params = {
+    TableName: TTL_TABLE_NAME,
+    Key:{
+      PK: {
+        S: messageUri,
+      },
+      SK: {
+        S: 'TTL',
+      },
+    }
+  };
+  const request = new DeleteItemCommand(params);
+  const output : DeleteItemCommandOutput = await dynamoDbClient.send(request);
+
+  return output.$metadata.httpStatusCode;
+}