@notabene/javascript-sdk 2.8.0-next.3 → 2.8.0-next.5

package/docs/types/type-aliases/Cancel.md

@@ -20,4 +20,4 @@ Represents a cancel component message
 
 ## Defined in
 
-[types.ts:869](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L869)
+[types.ts:885](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L885)

package/docs/types/type-aliases/Completed.md

@@ -32,4 +32,4 @@ The Response object which wraps T
 
 ## Defined in
 
-[types.ts:818](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L818)
+[types.ts:834](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L834)

package/docs/types/type-aliases/ComponentMessage.md

@@ -36,4 +36,4 @@ through these message types:
 
 ## Defined in
 
-[types.ts:907](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L907)
+[types.ts:923](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L923)

package/docs/types/type-aliases/ConnectionOptions.md

@@ -12,4 +12,4 @@ An object representing options for a Connection Request
 
 ## Defined in
 
-[types.ts:583](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L583)
+[types.ts:598](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L598)

package/docs/types/type-aliases/CryptoCredential.md

@@ -12,4 +12,4 @@ A crypto credential
 
 ## Defined in
 
-[types.ts:191](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L191)
+[types.ts:191](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L191)

package/docs/types/type-aliases/DID.md

@@ -12,4 +12,4 @@ A Decentralized Identifier
 
 ## Defined in
 
-[types.ts:219](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L219)
+[types.ts:219](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L219)

package/docs/types/type-aliases/DTI.md

@@ -35,4 +35,4 @@ Format: `DTI[NNNNN]` where N is a digit
 
 ## Defined in
 
-[types.ts:117](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L117)
+[types.ts:117](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L117)

package/docs/types/type-aliases/Destination.md

@@ -12,4 +12,4 @@ The destination of a transaction either a blockchain address, a CAIP-19 address,
 
 ## Defined in
 
-[types.ts:197](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L197)
+[types.ts:197](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L197)

package/docs/types/type-aliases/Error.md

@@ -42,4 +42,4 @@ Identifier code of the error message
 
 ## Defined in
 
-[types.ts:858](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L858)
+[types.ts:874](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L874)

package/docs/types/type-aliases/FieldOptions.md

@@ -6,10 +6,10 @@
 
 # Type Alias: FieldOptions
 
-> **FieldOptions**: `boolean` \| \{ `optional`: `boolean`; `transmit`: `boolean`; \}
+> **FieldOptions**: `boolean` \| `string`[] \| \{ `optional`: `boolean`; `transmit`: `boolean`; \}
 
 Field properties
 
 ## Defined in
 
-[types.ts:699](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L699)
+[types.ts:714](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L714)

package/docs/types/type-aliases/FieldTypes.md

@@ -22,4 +22,4 @@ Field type configuration
 
 ## Defined in
 
-[types.ts:711](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L711)
+[types.ts:727](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L727)

package/docs/types/type-aliases/HostMessage.md

@@ -34,4 +34,4 @@ without requiring full reinitialization.
 
 ## Defined in
 
-[types.ts:970](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L970)
+[types.ts:986](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L986)

package/docs/types/type-aliases/ISOCurrency.md

@@ -12,4 +12,4 @@
 
 ## Defined in
 
-[types.ts:231](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L231)
+[types.ts:231](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L231)

package/docs/types/type-aliases/InvalidValue.md

@@ -42,4 +42,4 @@ Array of validation errors
 
 ## Defined in
 
-[types.ts:880](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L880)
+[types.ts:896](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L896)

package/docs/types/type-aliases/LEI.md

@@ -12,4 +12,4 @@ A LEI Legal Entity Identifier
 
 ## Defined in
 
-[types.ts:225](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L225)
+[types.ts:225](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L225)

package/docs/types/type-aliases/LegalPersonFieldName.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[types.ts:430](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L430)
+[types.ts:430](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L430)

package/docs/types/type-aliases/LegalPersonFields.md

@@ -12,4 +12,4 @@ Field properties by field name
 
 ## Defined in
 
-[types.ts:444](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L444)
+[types.ts:444](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L444)

package/docs/types/type-aliases/NaturalPersonFieldName.md

@@ -12,4 +12,4 @@ Field names for NaturalPerson
 
 ## Defined in
 
-[types.ts:383](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L383)
+[types.ts:383](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L383)

package/docs/types/type-aliases/NaturalPersonFields.md

@@ -12,4 +12,4 @@ Field properties by field name for Natural persons
 
 ## Defined in
 
-[types.ts:398](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L398)
+[types.ts:398](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L398)

package/docs/types/type-aliases/NotabeneAsset.md

@@ -33,4 +33,4 @@ system that may be used alongside CAIP-19 and DTI identifiers.
 
 ## Defined in
 
-[types.ts:139](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L139)
+[types.ts:139](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L139)

package/docs/types/type-aliases/Ready.md

@@ -18,4 +18,4 @@ Represents a ready component message
 
 ## Defined in
 
-[types.ts:827](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L827)
+[types.ts:843](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L843)

package/docs/types/type-aliases/ResizeRequest.md

@@ -24,4 +24,4 @@ Represents a resize request component message. This is handled by the library.
 
 ## Defined in
 
-[types.ts:835](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L835)
+[types.ts:851](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L851)

package/docs/types/type-aliases/Source.md

@@ -12,4 +12,4 @@ The source of a transaction
 
 ## Defined in
 
-[types.ts:207](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L207)
+[types.ts:207](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L207)

package/docs/types/type-aliases/Theme.md

@@ -34,4 +34,4 @@ The theme of the Notabene SDK
 
 ## Defined in
 
-[types.ts:237](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L237)
+[types.ts:237](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L237)

package/docs/types/type-aliases/TransactionAsset.md

@@ -12,4 +12,4 @@ The asset of a transaction either a Notabene asset, a CAIP-19 asset, or a DTI.
 
 ## Defined in
 
-[types.ts:145](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L145)
+[types.ts:145](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L145)

package/docs/types/type-aliases/TravelAddress.md

@@ -34,4 +34,4 @@ VASPs and blockchain networks while maintaining privacy.
 
 ## Defined in
 
-[types.ts:186](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L186)
+[types.ts:186](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L186)

package/docs/types/type-aliases/URI.md

@@ -12,4 +12,4 @@ A Uniform Resource Identifier
 
 ## Defined in
 
-[types.ts:213](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L213)
+[types.ts:213](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L213)

package/docs/types/type-aliases/UUID.md

@@ -24,4 +24,4 @@ Format: 8-4-4-4-12 hexadecimal digits
 
 ## Defined in
 
-[types.ts:39](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L39)
+[types.ts:39](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L39)

package/docs/types/type-aliases/UpdateValue.md

@@ -51,4 +51,4 @@ and its configuration without requiring a full reload/reinitialize.
 
 ## Defined in
 
-[types.ts:948](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L948)
+[types.ts:964](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L964)

package/docs/types/type-aliases/V1Asset.md

@@ -33,4 +33,4 @@ Used for backwards compatibility with V1 API transaction payloads:
 
 ## Defined in
 
-[types.ts:614](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L614)
+[types.ts:629](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L629)

package/docs/types/type-aliases/V1Transaction.md

@@ -54,4 +54,4 @@ Transaction payload suitable for calling Notabene v1 tx/create
 
 ## Defined in
 
-[types.ts:620](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L620)
+[types.ts:635](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L635)

package/docs/types/type-aliases/VASPOptions.md

@@ -26,4 +26,4 @@ Options for which VASPs to be searchable
 
 ## Defined in
 
-[types.ts:733](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L733)
+[types.ts:749](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L749)

package/docs/types/type-aliases/ValidationError.md

@@ -22,4 +22,4 @@ Validation error
 
 ## Defined in
 
-[types.ts:690](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/7c1287c0f294e150fbd0ad5bc728bba0920f5ad7/src/types.ts#L690)
+[types.ts:705](https://gitlab.com/notabene/open-source/javascript-sdk/-/blob/80aada173fac6a9b5f05869abafa3c1c6cc56aa9/src/types.ts#L705)

package/package.json

@@ -10,7 +10,7 @@
   "author": "Notabene <developers@notabene.id>",
   "license": "MIT",
   "packageManager": "yarn@4.5.1",
-  "version": "2.8.0-next.3",
+  "version": "2.8.0-next.5",
   "source": "src/notabene.ts",
   "main": "dist/cjs/notabene.cjs",
   "module": "dist/esm/notabene.js",

package/src/notabene.ts

@@ -73,6 +73,13 @@ import { type MessageCallback } from './utils/MessageEventManager';
 import { decodeFragmentToObject, encodeObjectToFragment } from './utils/urls';
 // Must be exported for React Native SDK to use
 export { default as EmbeddedComponent } from './components/EmbeddedComponent';
+export {
+  ConnectionManager,
+  type ConnectionData,
+  type ConnectionMetadata,
+  type ConnectionResponse,
+  type TransactionType,
+} from './utils/connections';
 export {
   AgentType,
   CMType,

package/src/types.ts

@@ -713,6 +713,7 @@ export type ValidationError = {
  */
 export type FieldOptions =
   | boolean
+  | string[] // fields to show
   | {
       optional: boolean; // Shown but optional
       transmit: boolean; // Transmit as part of IVMS 101 to counterparty

package/src/utils/__tests__/connections.test.ts

@@ -0,0 +1,284 @@
+import fc from 'fast-check';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import type { DID } from '../../types';
+import { ConnectionManager, TransactionType } from '../connections';
+import { seal } from '../encryption';
+
+// Mock fetch globally
+const fetchMock = vi.fn();
+global.fetch = fetchMock;
+
+// Helper to generate valid DID strings
+const arbDID = fc
+  .tuple(fc.string(), fc.string())
+  .map(([method, id]) => `did:${method}:${id}` as DID);
+
+// Test helper to create arbitrary ComponentRequests
+const arbComponentRequest = fc.record({
+  tx: fc.record({
+    requestId: fc.option(fc.uuid(), { nil: undefined }),
+    customer: fc.option(
+      fc.record({
+        name: fc.string(),
+        email: fc.option(fc.string(), { nil: undefined }),
+        phone: fc.option(fc.string(), { nil: undefined }),
+        type: fc.constant(undefined), // Optional PersonType
+        accountNumber: fc.option(fc.string(), { nil: undefined }),
+        did: fc.option(arbDID, { nil: undefined }),
+        verified: fc.option(fc.boolean(), { nil: undefined }),
+        website: fc.option(fc.webUrl(), { nil: undefined }),
+        geographicAddress: fc.option(fc.constant(undefined), {
+          nil: undefined,
+        }),
+        nationalIdentification: fc.option(fc.constant(undefined), {
+          nil: undefined,
+        }),
+      }),
+      { nil: undefined },
+    ),
+  }),
+  authToken: fc.option(fc.string(), { nil: undefined }),
+  txOptions: fc.option(fc.record({}), { nil: undefined }),
+});
+
+// New arbitrary for ConnectionMetadata
+const arbConnectionMetadata = fc.record({
+  participants: fc.array(fc.string(), { minLength: 1 }), // At least one participant
+  nodeUrl: fc.webUrl(),
+  transactionType: fc.constantFrom<TransactionType>('withdraw', 'deposit'),
+});
+
+describe('ConnectionManager', () => {
+  let manager: ConnectionManager;
+  const testEndpoint = 'https://test-endpoint.com';
+
+  beforeEach(() => {
+    manager = new ConnectionManager(testEndpoint);
+    fetchMock.mockReset();
+  });
+
+  describe('create', () => {
+    it('should successfully create a new connection', async () => {
+      await fc.assert(
+        fc.asyncProperty(
+          arbComponentRequest,
+          arbConnectionMetadata,
+          async (request, metadata) => {
+            // Mock successful response
+            const mockResponse = {
+              id: 'test-id',
+              version: 1,
+              metadata,
+              sealed: ['encrypted-data'],
+            };
+
+            fetchMock.mockResolvedValueOnce({
+              ok: true,
+              json: async () => mockResponse,
+            });
+
+            const result = await manager.create(request, metadata);
+
+            // Verify fetch was called correctly
+            expect(fetchMock).toHaveBeenCalledWith(testEndpoint, {
+              method: 'POST',
+              headers: {
+                'Content-Type': 'application/json',
+              },
+              body: expect.any(String),
+            });
+
+            // Verify response structure
+            expect(result).toEqual({
+              id: mockResponse.id,
+              metadata: mockResponse.metadata,
+              version: mockResponse.version,
+              data: request,
+              key: expect.any(String),
+            });
+          },
+        ),
+      );
+    });
+
+    it('should throw error on failed creation', async () => {
+      await fc.assert(
+        fc.asyncProperty(
+          arbComponentRequest,
+          arbConnectionMetadata,
+          async (request, metadata) => {
+            // Mock failed response
+            fetchMock.mockResolvedValueOnce({
+              ok: false,
+              text: async () => 'Creation failed',
+            });
+
+            await expect(manager.create(request, metadata)).rejects.toThrow(
+              'Failed to create connection',
+            );
+          },
+        ),
+      );
+    });
+  });
+
+  describe('update', () => {
+    it('should successfully update an existing connection', async () => {
+      await fc.assert(
+        fc.asyncProperty(
+          fc.uuid(),
+          arbComponentRequest,
+          fc.integer(),
+          async (id, request, version) => {
+            // Mock successful response
+            const mockResponse = {
+              id,
+              metadata: arbConnectionMetadata,
+              version: version + 1,
+              sealed: ['new-encrypted-data'],
+            };
+
+            fetchMock.mockResolvedValueOnce({
+              ok: true,
+              json: async () => mockResponse,
+            });
+
+            const result = await manager.update(id, request, version);
+
+            // Verify fetch was called correctly
+            expect(fetchMock).toHaveBeenCalledWith(`${testEndpoint}/${id}`, {
+              method: 'PATCH',
+              headers: {
+                'Content-Type': 'application/json',
+              },
+              body: expect.any(String),
+            });
+
+            // Verify response structure
+            expect(result).toEqual({
+              id: mockResponse.id,
+              version: mockResponse.version,
+              metadata: mockResponse.metadata,
+              data: request,
+              key: expect.any(String),
+            });
+          },
+        ),
+      );
+    });
+
+    it('should throw error on failed update', async () => {
+      await fc.assert(
+        fc.asyncProperty(
+          fc.uuid(),
+          arbComponentRequest,
+          fc.integer(),
+          async (id, request, version) => {
+            // Mock failed response
+            fetchMock.mockResolvedValueOnce({
+              ok: false,
+              text: async () => 'Update failed',
+            });
+
+            await expect(manager.update(id, request, version)).rejects.toThrow(
+              'Failed to update connection',
+            );
+          },
+        ),
+      );
+    });
+  });
+
+  describe('get', () => {
+    it('should successfully retrieve and decrypt connection data', async () => {
+      // Create a real sealed object to use in our test
+      const testData = { requestId: 'test-123' };
+      const sealed = await seal(testData);
+
+      await fc.assert(
+        fc.asyncProperty(fc.uuid(), async (id) => {
+          // Mock successful response with real encrypted data
+          const mockResponse = {
+            id,
+            version: 1,
+            metadata: arbConnectionMetadata,
+            sealed: [sealed.ciphertext], // Use the real ciphertext
+          };
+
+          fetchMock.mockResolvedValueOnce({
+            ok: true,
+            json: async () => mockResponse,
+          });
+
+          const result = await manager.get(id, sealed.key); // Use the matching key
+
+          // Verify fetch was called correctly
+          expect(fetchMock).toHaveBeenCalledWith(`${testEndpoint}/${id}`, {
+            method: 'GET',
+          });
+
+          // Verify response structure
+          expect(result).toEqual({
+            id: mockResponse.id,
+            version: mockResponse.version,
+            metadata: mockResponse.metadata,
+            data: testData, // Should match our original test data
+            key: sealed.key,
+          });
+        }),
+      );
+    });
+
+    it('should throw error on failed retrieval', async () => {
+      await fc.assert(
+        fc.asyncProperty(fc.uuid(), fc.string(), async (id, key) => {
+          // Mock failed response
+          fetchMock.mockResolvedValueOnce({
+            ok: false,
+            text: async () => 'Retrieval failed',
+          });
+
+          await expect(manager.get(id, key)).rejects.toThrow(
+            'Failed to get connection',
+          );
+        }),
+      );
+    });
+  });
+
+  describe('close', () => {
+    it('should successfully close a connection', async () => {
+      await fc.assert(
+        fc.asyncProperty(fc.uuid(), async (id) => {
+          // Mock successful response
+          fetchMock.mockResolvedValueOnce({
+            ok: true,
+          });
+
+          await manager.close(id);
+
+          // Verify fetch was called correctly
+          expect(fetchMock).toHaveBeenCalledWith(`${testEndpoint}/${id}`, {
+            method: 'DELETE',
+          });
+        }),
+      );
+    });
+
+    it('should throw error on failed closure', async () => {
+      await fc.assert(
+        fc.asyncProperty(fc.uuid(), async (id) => {
+          // Mock failed response
+          fetchMock.mockResolvedValueOnce({
+            ok: false,
+            text: async () => 'Closure failed',
+          });
+
+          await expect(manager.close(id)).rejects.toThrow(
+            'Failed to close connection',
+          );
+        }),
+      );
+    });
+  });
+});

package/src/utils/__tests__/encryption.test.ts

@@ -0,0 +1,79 @@
+import * as fc from 'fast-check';
+import { describe, expect, it } from 'vitest';
+import { Agent, AgentType } from '../../types';
+import { seal, unseal } from '../encryption';
+
+// Helper to validate that two objects are deeply equal
+function deepEqual(
+  obj1: Record<string, unknown>,
+  obj2: Record<string, unknown>,
+): boolean {
+  return JSON.stringify(obj1) === JSON.stringify(obj2);
+}
+
+describe('normal tests', () => {
+  it('should correctly seal and unseal a Javascript object', async () => {
+    const agent: Agent = { type: AgentType.VASP, did: 'did:web:hello.com' };
+    const sealed = await seal<Agent>(agent);
+    const unsealed = await unseal<Agent>(sealed);
+    expect(unsealed).toEqual(agent);
+  });
+});
+describe('seal and unseal functions with combined IV and ciphertext', () => {
+  it('should correctly seal and unseal a JavaScript object', async () => {
+    await fc.assert(
+      fc.asyncProperty(
+        fc.object(), // Generate random objects
+        async (originalObject) => {
+          const { ciphertext, key } =
+            await seal<Record<string, unknown>>(originalObject); // Seal the object
+          const unsealedObject = await unseal<Record<string, unknown>>({
+            ciphertext,
+            key,
+          }); // Unseal the ciphertext
+
+          // Validate that the unsealed object matches the original
+          expect(deepEqual(originalObject, unsealedObject)).toBe(true);
+        },
+      ),
+    );
+  });
+
+  it('should throw an error if the key is invalid', async () => {
+    await fc.assert(
+      fc.asyncProperty(
+        fc.object(),
+        fc.string(), // Generate a random invalid key
+        async (originalObject, invalidKey) => {
+          const { ciphertext } =
+            await seal<Record<string, unknown>>(originalObject);
+
+          await expect(
+            unseal<Record<string, unknown>>({ ciphertext, key: invalidKey }),
+          ).rejects.toThrowError();
+        },
+      ),
+    );
+  });
+
+  it('should throw an error if the ciphertext is tampered with', async () => {
+    await fc.assert(
+      fc.asyncProperty(fc.object(), async (originalObject) => {
+        const { ciphertext, key } =
+          await seal<Record<string, unknown>>(originalObject);
+
+        // Tamper with the ciphertext
+        const tamperedCiphertext =
+          ciphertext.slice(0, -1) + (ciphertext.at(-1) === 'A' ? 'B' : 'A');
+
+        // Expect decryption to fail
+        await expect(
+          unseal<Record<string, unknown>>({
+            ciphertext: tamperedCiphertext,
+            key,
+          }),
+        ).rejects.toThrowError();
+      }),
+    );
+  });
+});