@verana-labs/vs-agent-nestjs-client 2.0.0-dev.7 → 2.0.0-dev.72

package/README.md

@@ -1,222 +1,82 @@
-`@verana-labs/vs-agent-nestjs-client`
-# Nestjs-client for VS Agent
-The `nestjs-client` library simplifies the integration of VS Agent components in your NestJS applications. It provides several modules that follow a plug-and-play architecture, allowing you to incorporate them based on your needs. Certain modules, such as credential management, recommend using the message handling module for seamless operation.
-
-## Available Modules
-1. Message Handling:
-    - Manages the events related to message states, including when a message is sent, delivered, or received.
-    - Use this module if you're integrating messaging functionality into your application.
-2. Credential Management:
-    - Handles the lifecycle of credentials, including offering, accepting, rejecting, and revoking credentials.
-    - This module is typically used when you need to manage digital credentials for your application.
-3. Connection Management:
-    - Manages events related to connection state changes.
-
-## How to work
-```mermaid
-classDiagram
-    class VsAgent {
-        + Handles DIDComm communication
-        + Manages agent wallet and credentials
-        + Exposes API for client interactions
-    }
-
-    class NestJSClient {
-        + Plug-and-play integration
-        + Selectable modules for various services
-        + Modules:
-        -- MessageEventOptions: Configures message event handling
-        -- ConnectionEventOptions: Configures connection event handling
-        -- CredentialOptions: Configures credential management
-        -- StatsOptions: Configures stats management
-    }
-
-    class Client {
-        + Directly manages requests to SA
-        + Facilitates reception of requests from modules
-        + Provides an abstraction for service communication
-        + Interfaces:
-        -- messages
-        -- credentialTypes
-        -- revocationRegistries
-        -- invitations
-    }
-
-    class ModelLibrary {
-        + Defines required data models
-        + Ensures type safety across services
-    }
-
-    %% Relations
-    NestJSClient --> VsAgent : Uses
-    Client --> VsAgent : Sends requests
-    Client --> VsAgent : Receives requests
-    Client --> ModelLibrary : Uses models
-    ModelLibrary --> VsAgent : Provides data models
-    NestJSClient --> ModelLibrary : Uses models
-
-    %% Style
-    style NestJSClient stroke:#333,stroke-width:4px
-```
+# @verana-labs/vs-agent-nestjs-client
+
+NestJS module for hosts of a VS Agent. It mounts the Events API webhook, keeps a small table of connections and issued credentials, and provides a configured `ApiClient` from `@verana-labs/vs-agent-client` for injection. Everything the client exports is re-exported here.
+
+## Setup
 
-## Configuration
-### Dynamic Module Setup
-The `nestjs-client` allows dynamic configuration through various module options defined in `types.ts`. You can configure individual modules or the `EventsModule` for handling multiple events at once
-### Key Configuration Options
-- `eventHandler`: Specifies the event handler class to handle incoming events. It must implement the `EventHandler` interface.
-- `imports`: An array of additional modules to import, such as service modules or other shared functionality.
-- `url`: VS Agent Admin API URL
-- `version`: Specifies the version of VS Agent API to use.
-- `statOptions`: Configuration options for the **JMS (Jakarta Message Service) broker**, including host, port, queue name, authentication, and reconnection settings. The default broker used is **Apache Artemis**. 
-
-### `statOptions` Parameters  
-The `statOptions` object includes the following properties for configuring the message broker:  
-
-| Parameter       | Type      | Description |
-|---------------|---------|-------------|
-| `host`        | `string`  | The hostname or IP address of the JMS broker. |
-| `port`        | `number`  | The port used to connect to the JMS broker. |
-| `queue`       | `string`  | The name of the message queue to use. |
-| `username`    | `string`  | The username for authenticating with the broker (if required). |
-| `password`    | `string`  | The password for authentication (if required). |
-| `reconnectLimit` | `number` | The maximum number of reconnection attempts in case of a connection failure. |
-| `threads`     | `number`  | The number of worker threads for processing messages. |
-| `delay`       | `number`  | The delay (in milliseconds) before retrying a failed connection or message processing. |
-
-#### `MessageEventOptions`
-Configures message event handling. The following properties are available:
-- `eventHandler` (optional).
-- `imports` (optional).
-- `url` (mandatory).
-- `version` (optional).
-#### `ConnectionEventOptions`
-Configures connection event handling. The following properties are available:
-- `eventHandler` (optional).
-- `imports` (optional).
-
-#### `CredentialOptions`
-Configures credential management. The following properties are available:
-- `imports` (optional).
-- `url` (mandatory).
-- `version` (optional).
-
-#### `StatsOptions`
-Configures stats management. The following properties are available:
-- `imports` (optional).
-- `statOptions` (optional).
-
-##### Example of Using the `StatEventModule`
-
-This example demonstrates how to configure and use the `StatEventModule` to send and process statistics using a JMS broker:
-
-- **AppModule**
 ```typescript
-import { Module } from '@nestjs/common';
-import { StatEventModule } from '@verana-labs/vs-agent-nestjs-client';
-
-EventsModule.register({
-  modules: {
-    ...
-    stats: true,
-  },
-  options: {
-    statOptions: {
-        host: 'jms-broker.example.com',
-        port: 61616,
-        queue: 'stats-queue', // The queue must be unique
-        username: 'admin',
-        password: 'password123',
-        reconnectLimit: 5,
-        threads: 10,
-        delay: 1000,
-      },
-    eventHandler: CoreService,
-    url: 'http://localhost',
-    imports: [],
-  },
+import { EventsModule } from '@verana-labs/vs-agent-nestjs-client'
+
+@Module({
+  imports: [
+    EventsModule.register({
+      url: process.env.VS_AGENT_ADMIN_URL,
+      eventHandler: CoreService,
+      modules: { connections: true, credentials: true },
+    }),
+  ],
 })
+export class AppModule {}
 ```
 
-- **STAT_KPI**
-```typescript
-export enum STAT_KPI {
-  USER_CONNECTED,
-}
-```
+Options:
+
+| Option | Description |
+|---|---|
+| `url` | Admin API origin, for example `http://localhost:3000`. The client appends `/v2` |
+| `token` | Bearer token for corporation mode. Omit in internal mode |
+| `webhookApiKey` | When set, `POST /events` requires `Authorization: Bearer <webhookApiKey>` |
+| `eventHandler` | Class implementing `EventHandler`, registered as a provider |
+| `modules.connections` | `true` or `{ requireProfile }`. Tracks connections and derives `newConnection` and `closeConnection`. With `requireProfile`, `newConnection` waits for a profile carrying `preferredLanguage` |
+| `modules.credentials` | Tracks issued credentials and their revocation registries |
+| `modules.stats` | Registers `StatProducerService` |
+| `statOptions` | JMS broker settings for the stats producer (`host`, `port`, `queue`, `username`, `password`, `reconnectLimit`, `threads`, `delay`) |
+
+The module is global. It exports `VS_AGENT_CLIENT` and whichever of `ConnectionsRepository`, `ConnectionsService`, `CredentialService` and `StatProducerService` are registered.
 
-- **StatProducerService**
-After configuring the `StatEventModule`, you can inject the `StatProducerService` into your services to send statistics to the configured JMS broker:
+The host owns the database. Register the entities it uses with `TypeOrmModule.forFeature([ConnectionEntity, CredentialEntity, RevocationRegistryEntity])` in a module that exports `TypeOrmModule`. Migration based deployments coming from the v1 client write one migration for the `connections.status` enum (now `start`, `completed`, `terminated`), the dropped `connections.metadata` column and the `credentials.threadId` to `credentialExchangeId` rename.
+
+## Webhook
+
+The module mounts `POST /events` and answers 204. Point the agent's `EVENTS_WEBHOOK_URL` at it. A repeated envelope `id` is discarded before dispatch. Errors thrown by `onEvent` propagate, so the agent logs the delivery as failed.
+
+## EventHandler
 
 ```typescript
-import { STAT_KPI } from './common'
-import { StatEnum, StatProducerService } from '@verana-labs/vs-agent-nestjs-client'
-
-export class CoreService implements EventHandler, OnModuleInit {
-  constructor(
-    @InjectRepository(SessionEntity)
-    private readonly statProducer: StatProducerService,
-  ) {}
-  
-  await this.statProducer.spool(STAT_KPI.USER_CONNECTED, 'uuid', [new StatEnum(0, 'string')])
+export interface EventHandler {
+  newConnection(connectionId: string): Promise<void> | void
+  closeConnection(connectionId: string): Promise<void> | void
+  onEvent(envelope: EventEnvelope | UnknownEventEnvelope): Promise<void> | void
 }
 ```
 
+`onEvent` receives every envelope after the module has acted on it. Check `isEventEnvelope(envelope)` first, then switch on `envelope.type` to get typed `envelope.data`. The else branch is reachable: extension modules emit types the map does not list, and there `envelope.data` is `unknown`.
 
-#### `ModulesConfig`
-This interface defines the configuration for enabling or disabling modules:
-- `messages` (optional): Whether to enable the message handling module. Defaults to false.
-- `connections` (optional): Whether to enable the connection management module. Defaults to false.
-- `credentials` (optional): Whether to enable the credential management module. Defaults to false.
-- `stats` (optional): Whether to enable the stats management module. Defaults to false.
+## Connections
 
-#### `EventsModuleOptions`
-This configuration interface is used to configure multiple modules at once via the EventsModule:
-- `modules`: Specifies which modules to enable (messages, connections, and credentials).
-- `options`: Contains common configuration options that apply to each module, such as eventHandler, imports, url, and version.
+`didcomm.connections.state-updated` with `state: 'completed'` creates the row. `didcomm.user-profile.profile-received` stores the profile. `newConnection` fires once per connection, once it is `completed` and a profile with `preferredLanguage` has been received when `requireProfile` is true (the default), or right after `completed` when it is false. `closeConnection` fires on `state: 'abandoned'`. A peer hangup by DID rotation emits no Events API event today, so it does not reach `closeConnection`.
 
+`newConnection` also fires for the connection each accepted credential offer or proof request creates, since those go through an out of band invitation.
 
+## Credentials
 
+`CredentialService` wraps the v2 credential offer flow.
 
-### Example of Using Independent Modules
-This example demonstrates how to use each module separately:
-```typescript
-@Module({
-  imports: [
-    MessageEventModule.forRoot({
-      messageHandler: CustomMessageHandler, // Class with input method
-      imports: [],
-      url: 'http://vsa-url.com',
-      version: ApiVersion.V1,
-    }),
-    CredentialManagementModule.forRoot({
-      // Configuration options
-    }),
-  ],
-})
-export class AppModule {}
-```
+- `createCredentialDefinition(jsonSchemaCredentialId, { supportRevocation, maximumCredentialNumber })` returns the definition for that schema, creating it and two revocation registries when missing. Call it once at startup.
+- `issue(claims, { connectionId, refId, credentialDefinitionId, jsonSchemaCredentialId, revokeIfAlreadyIssued })` picks a definition, reserves a revocation index and calls `createCredentialOffer` with `autoAccept: true`. It returns the offer, hand its `shortUrl` to the user. `connectionId` is bookkeeping only, it is the connection `revoke(connectionId)` looks up by. `issue` no longer registers a credential definition, run `createCredentialDefinition` first.
+- `didcomm.credential-exchanges.state-updated` with `role: 'issuer'` marks the row accepted on `done` and rejected on `declined` or `abandoned`.
+- `revoke(connectionId, credentialExchangeId?)` revokes the latest accepted credential of the connection, or the given exchange, through `revokeCredential`.
+
+## Client
+
+Inject the configured client anywhere:
 
-###  Example of Using the Recommended `EventsModule`
-The recommended approach is to use the `EventsModule` to register multiple modules at once for easier configuration:
 ```typescript
-@Module({
-  imports: [
-    EventsModule.register({
-      modules: {
-        messages: true,
-        credentials: true,
-      },
-      options: {
-        eventHandler: CoreService,
-        imports: [],
-        url: process.env.VS_AGENT_ADMIN_URL,
-        version: ApiVersion.V1,
-      },
-    }),
-  ],
-})
-export class AppModule {}
+constructor(@Inject(VS_AGENT_CLIENT) private readonly client: ApiClient) {}
+
+await this.client.didcomm.sendBasicMessage({ connectionId, content: 'hello' })
 ```
-In this example, the `EventsModule` is used to register multiple modules simultaneously, which ensures better integration and streamlined configuration for common use cases.
 
-For more information on dynamic modules and their configuration in NestJS, refer to the official [documentation](https://docs.nestjs.com/fundamentals/dynamic-modules)
+## Stats
+
+With `modules.stats` the `StatProducerService` sends `StatEvent` messages to a JMS queue. Call `spool(statClass, entityId, [new StatEnum(0, 'value')])` or `spoolSingle`.

package/build/app.module.js

@@ -9,48 +9,40 @@ var EventsModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventsModule = void 0;
 const common_1 = require("@nestjs/common");
+const vs_agent_client_1 = require("@verana-labs/vs-agent-client");
 const connections_1 = require("./connections");
 const credentials_1 = require("./credentials");
+const events_controller_1 = require("./events.controller");
+const events_service_1 = require("./events.service");
 const jms_1 = require("./jms");
-const messages_1 = require("./messages");
+const tokens_1 = require("./tokens");
 let EventsModule = EventsModule_1 = class EventsModule {
     static register(options) {
-        var _a, _b, _c, _d;
-        const imports = [];
-        const { modules, options: moduleOptions } = options;
-        if (modules.messages) {
-            imports.push(messages_1.MessageEventModule.forRoot({
-                eventHandler: moduleOptions.eventHandler,
-                imports: (_a = moduleOptions.imports) !== null && _a !== void 0 ? _a : [],
-                url: moduleOptions.url,
-                version: moduleOptions.version,
-            }));
+        var _a;
+        const { connections, credentials, stats } = (_a = options.modules) !== null && _a !== void 0 ? _a : {};
+        const providers = [
+            { provide: tokens_1.EVENTS_MODULE_OPTIONS, useValue: options },
+            { provide: tokens_1.EVENT_HANDLER, useClass: options.eventHandler },
+            {
+                provide: tokens_1.VS_AGENT_CLIENT,
+                useFactory: () => new vs_agent_client_1.ApiClient(options.url, { token: options.token }),
+            },
+            events_service_1.EventsService,
+        ];
+        const exports = [tokens_1.VS_AGENT_CLIENT];
+        if (connections) {
+            providers.push(connections_1.ConnectionsRepository, connections_1.ConnectionsService);
+            exports.push(connections_1.ConnectionsRepository, connections_1.ConnectionsService);
         }
-        if (modules.connections) {
-            imports.push(connections_1.ConnectionsEventModule.forRoot({
-                eventHandler: moduleOptions.eventHandler,
-                imports: (_b = moduleOptions.imports) !== null && _b !== void 0 ? _b : [],
-                useMessages: modules.messages,
-            }));
+        if (credentials) {
+            providers.push(credentials_1.CredentialService);
+            exports.push(credentials_1.CredentialService);
         }
-        if (modules.credentials) {
-            imports.push(credentials_1.CredentialModule.forRoot({
-                imports: (_c = moduleOptions.imports) !== null && _c !== void 0 ? _c : [],
-                url: moduleOptions.url,
-                version: moduleOptions.version,
-            }));
+        if (stats) {
+            providers.push(jms_1.StatProducerService);
+            exports.push(jms_1.StatProducerService);
         }
-        if (modules.stats) {
-            imports.push(jms_1.StatEventModule.forRoot({
-                imports: (_d = moduleOptions.imports) !== null && _d !== void 0 ? _d : [],
-                statOptions: moduleOptions.statOptions,
-            }));
-        }
-        return {
-            module: EventsModule_1,
-            imports,
-            exports: imports,
-        };
+        return { module: EventsModule_1, controllers: [events_controller_1.EventsController], providers, exports };
     }
 };
 exports.EventsModule = EventsModule;

package/build/app.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA8D;AAE9D,+CAAsD;AACtD,+CAAgD;AAChD,+BAAuC;AACvC,yCAA+C;AAKxC,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,OAA4B;;QAC1C,MAAM,OAAO,GAAG,EAAE,CAAA;QAClB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAA;QAEnD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACV,6BAAkB,CAAC,OAAO,CAAC;gBACzB,YAAY,EAAE,aAAa,CAAC,YAAY;gBACxC,OAAO,EAAE,MAAA,aAAa,CAAC,OAAO,mCAAI,EAAE;gBACpC,GAAG,EAAE,aAAa,CAAC,GAAG;gBACtB,OAAO,EAAE,aAAa,CAAC,OAAO;aAC/B,CAAC,CACH,CAAA;QACH,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CACV,oCAAsB,CAAC,OAAO,CAAC;gBAC7B,YAAY,EAAE,aAAa,CAAC,YAAY;gBACxC,OAAO,EAAE,MAAA,aAAa,CAAC,OAAO,mCAAI,EAAE;gBACpC,WAAW,EAAE,OAAO,CAAC,QAAQ;aAC9B,CAAC,CACH,CAAA;QACH,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CACV,8BAAgB,CAAC,OAAO,CAAC;gBACvB,OAAO,EAAE,MAAA,aAAa,CAAC,OAAO,mCAAI,EAAE;gBACpC,GAAG,EAAE,aAAa,CAAC,GAAG;gBACtB,OAAO,EAAE,aAAa,CAAC,OAAO;aAC/B,CAAC,CACH,CAAA;QACH,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CACV,qBAAe,CAAC,OAAO,CAAC;gBACtB,OAAO,EAAE,MAAA,aAAa,CAAC,OAAO,mCAAI,EAAE;gBACpC,WAAW,EAAE,aAAa,CAAC,WAAW;aACvC,CAAC,CACH,CAAA;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,OAAO;YACP,OAAO,EAAE,OAAO;SACjB,CAAA;IACH,CAAC;CACF,CAAA;AAnDY,oCAAY;uBAAZ,YAAY;IAFxB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,YAAY,CAmDxB"}
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAwE;AACxE,kEAAwD;AAExD,+CAAyE;AACzE,+CAAiD;AACjD,2DAAsD;AACtD,qDAAgD;AAChD,+BAA2C;AAC3C,qCAAgF;AAKzE,IAAM,YAAY,oBAAlB,MAAM,YAAY;IAChB,MAAM,CAAC,QAAQ,CAAC,OAA4B;;QACjD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,EAAE,CAAA;QACjE,MAAM,SAAS,GAAe;YAC5B,EAAE,OAAO,EAAE,8BAAqB,EAAE,QAAQ,EAAE,OAAO,EAAE;YACrD,EAAE,OAAO,EAAE,sBAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE;YAC1D;gBACE,OAAO,EAAE,wBAAe;gBACxB,UAAU,EAAE,GAAc,EAAE,CAAC,IAAI,2BAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;aAClF;YACD,8BAAa;SACd,CAAA;QACD,MAAM,OAAO,GAA0C,CAAC,wBAAe,CAAC,CAAA;QAExE,IAAI,WAAW,EAAE,CAAC;YAChB,SAAS,CAAC,IAAI,CAAC,mCAAqB,EAAE,gCAAkB,CAAC,CAAA;YACzD,OAAO,CAAC,IAAI,CAAC,mCAAqB,EAAE,gCAAkB,CAAC,CAAA;QACzD,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,SAAS,CAAC,IAAI,CAAC,+BAAiB,CAAC,CAAA;YACjC,OAAO,CAAC,IAAI,CAAC,+BAAiB,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,SAAS,CAAC,IAAI,CAAC,yBAAmB,CAAC,CAAA;YACnC,OAAO,CAAC,IAAI,CAAC,yBAAmB,CAAC,CAAA;QACnC,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,cAAY,EAAE,WAAW,EAAE,CAAC,oCAAgB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IACtF,CAAC;CACF,CAAA;AA7BY,oCAAY;uBAAZ,YAAY;IAFxB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,YAAY,CA6BxB"}

package/build/connections/connection.entity.d.ts

@@ -1,10 +1,9 @@
-import { ExtendedDidExchangeState } from '@verana-labs/vs-agent-model';
-import { UserProfile } from '../types';
+import { ReceivedUserProfile } from '@verana-labs/vs-agent-client';
+import { ConnectionStatus } from '../types';
 export declare class ConnectionEntity {
     id?: string;
-    status?: ExtendedDidExchangeState;
-    userProfile?: UserProfile;
+    status?: ConnectionStatus;
+    userProfile?: ReceivedUserProfile;
     createdTs?: Date;
     updatedTs?: Date;
-    metadata?: Record<string, any>;
 }

package/build/connections/connection.entity.js

@@ -10,8 +10,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectionEntity = void 0;
-const vs_agent_model_1 = require("@verana-labs/vs-agent-model");
 const typeorm_1 = require("typeorm");
+const types_1 = require("../types");
 let ConnectionEntity = class ConnectionEntity {
 };
 exports.ConnectionEntity = ConnectionEntity;
@@ -20,11 +20,7 @@ __decorate([
     __metadata("design:type", String)
 ], ConnectionEntity.prototype, "id", void 0);
 __decorate([
-    (0, typeorm_1.Column)({
-        type: 'enum',
-        enum: vs_agent_model_1.ExtendedDidExchangeState,
-        default: vs_agent_model_1.ExtendedDidExchangeState.Start,
-    }),
+    (0, typeorm_1.Column)({ type: 'enum', enum: types_1.ConnectionStatus, default: types_1.ConnectionStatus.Start }),
     __metadata("design:type", String)
 ], ConnectionEntity.prototype, "status", void 0);
 __decorate([
@@ -39,10 +35,6 @@ __decorate([
     (0, typeorm_1.UpdateDateColumn)(),
     __metadata("design:type", Date)
 ], ConnectionEntity.prototype, "updatedTs", void 0);
-__decorate([
-    (0, typeorm_1.Column)('jsonb', { nullable: true }),
-    __metadata("design:type", Object)
-], ConnectionEntity.prototype, "metadata", void 0);
 exports.ConnectionEntity = ConnectionEntity = __decorate([
     (0, typeorm_1.Entity)('connections')
 ], ConnectionEntity);

package/build/connections/connection.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.entity.js","sourceRoot":"","sources":["../../src/connections/connection.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gEAAsE;AACtE,qCAAoG;AAK7F,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAsB5B,CAAA;AAtBY,4CAAgB;AAE3B;IADC,IAAA,gCAAsB,EAAC,MAAM,CAAC;;4CACpB;AAOX;IALC,IAAA,gBAAM,EAAC;QACN,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,yCAAwB;QAC9B,OAAO,EAAE,yCAAwB,CAAC,KAAK;KACxC,CAAC;;gDAC+B;AAGjC;IADC,IAAA,gBAAM,EAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDACX;AAGzB;IADC,IAAA,0BAAgB,GAAE;8BACP,IAAI;mDAAA;AAGhB;IADC,IAAA,0BAAgB,GAAE;8BACP,IAAI;mDAAA;AAGhB;IADC,IAAA,gBAAM,EAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACN;2BArBnB,gBAAgB;IAD5B,IAAA,gBAAM,EAAC,aAAa,CAAC;GACT,gBAAgB,CAsB5B"}
+{"version":3,"file":"connection.entity.js","sourceRoot":"","sources":["../../src/connections/connection.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,qCAAoG;AAEpG,oCAA2C;AAGpC,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAe5B,CAAA;AAfY,4CAAgB;AAE3B;IADC,IAAA,gCAAsB,EAAC,MAAM,CAAC;;4CACpB;AAGX;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAgB,EAAE,OAAO,EAAE,wBAAgB,CAAC,KAAK,EAAE,CAAC;;gDACzD;AAGzB;IADC,IAAA,gBAAM,EAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDACH;AAGjC;IADC,IAAA,0BAAgB,GAAE;8BACP,IAAI;mDAAA;AAGhB;IADC,IAAA,0BAAgB,GAAE;8BACP,IAAI;mDAAA;2BAdL,gBAAgB;IAD5B,IAAA,gBAAM,EAAC,aAAa,CAAC;GACT,gBAAgB,CAe5B"}

package/build/connections/connection.repository.d.ts

@@ -1,27 +1,13 @@
-import { ExtendedDidExchangeState } from '@verana-labs/vs-agent-model';
+import { ReceivedUserProfile } from '@verana-labs/vs-agent-client';
 import { Repository } from 'typeorm';
-import { UserProfile } from '../types';
+import { ConnectionStatus } from '../types';
 import { ConnectionEntity } from './connection.entity';
 export declare class ConnectionsRepository {
     private readonly repository;
     constructor(repository: Repository<ConnectionEntity>);
-    create(connection: Partial<ConnectionEntity>): Promise<ConnectionEntity>;
-    findAll(): Promise<ConnectionEntity[]>;
+    create(connection: Partial<ConnectionEntity>): Promise<void>;
     findById(id: string): Promise<ConnectionEntity | undefined>;
-    updateStatus(id: string, status: ExtendedDidExchangeState): Promise<ConnectionEntity | undefined>;
-    updateUserProfile(id: string, userProfile: UserProfile): Promise<ConnectionEntity | undefined>;
-    updateMetadata(id: string, metadata: Record<string, any>): Promise<ConnectionEntity | undefined>;
-    /**
-     * Checks if a connection has been completed.
-     *
-     * This method verifies whether the connection's `lang` (if required)
-     * and `metadata` meet the completion criteria.
-     * @param id The unique identifier of the connection to validate
-     * @param requireLang If `true`, ensures that `lang` is not `null`
-     * @returns A promise that resolves to `true` if:
-     *   - `metadata` is either `undefined` or a non-empty object.
-     *   - If `requireLang` is `true`, `lang` must not be `null`.
-     * @throws Error if the connection is not found or if `createdTs` is missing.
-     */
-    isCompleted(id: string, requireLang: boolean): Promise<boolean>;
+    updateStatus(id: string, status: ConnectionStatus): Promise<boolean>;
+    updateUserProfile(id: string, userProfile: ReceivedUserProfile): Promise<void>;
+    isCompleted(id: string, requireProfile: boolean): Promise<boolean>;
 }

package/build/connections/connection.repository.js

@@ -15,20 +15,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectionsRepository = void 0;
 const common_1 = require("@nestjs/common");
 const typeorm_1 = require("@nestjs/typeorm");
-const vs_agent_model_1 = require("@verana-labs/vs-agent-model");
 const typeorm_2 = require("typeorm");
+const types_1 = require("../types");
 const connection_entity_1 = require("./connection.entity");
-// TypeORM
 let ConnectionsRepository = class ConnectionsRepository {
     constructor(repository) {
         this.repository = repository;
     }
     async create(connection) {
-        const entity = this.repository.create(connection);
-        return await this.repository.save(entity);
-    }
-    async findAll() {
-        return await this.repository.find();
+        await this.repository.createQueryBuilder().insert().values(connection).orIgnore().execute();
     }
     async findById(id) {
         var _a;
@@ -36,46 +31,23 @@ let ConnectionsRepository = class ConnectionsRepository {
     }
     async updateStatus(id, status) {
         var _a;
-        await this.repository.update(id, { status });
-        return (_a = (await this.repository.findOne({ where: { id } }))) !== null && _a !== void 0 ? _a : undefined;
+        const result = await this.repository.update(id, { status });
+        return ((_a = result.affected) !== null && _a !== void 0 ? _a : 0) > 0;
     }
     async updateUserProfile(id, userProfile) {
-        var _a;
         await this.repository.update(id, { userProfile });
-        return (_a = (await this.repository.findOne({ where: { id } }))) !== null && _a !== void 0 ? _a : undefined;
-    }
-    async updateMetadata(id, metadata) {
-        var _a;
-        await this.repository.update(id, { metadata });
-        return (_a = (await this.repository.findOne({ where: { id } }))) !== null && _a !== void 0 ? _a : undefined;
     }
-    /**
-     * Checks if a connection has been completed.
-     *
-     * This method verifies whether the connection's `lang` (if required)
-     * and `metadata` meet the completion criteria.
-     * @param id The unique identifier of the connection to validate
-     * @param requireLang If `true`, ensures that `lang` is not `null`
-     * @returns A promise that resolves to `true` if:
-     *   - `metadata` is either `undefined` or a non-empty object.
-     *   - If `requireLang` is `true`, `lang` must not be `null`.
-     * @throws Error if the connection is not found or if `createdTs` is missing.
-     */
-    async isCompleted(id, requireLang) {
+    async isCompleted(id, requireProfile) {
         var _a;
         const conn = await this.findById(id);
-        if (!(conn === null || conn === void 0 ? void 0 : conn.id)) {
-            throw new Error(`No connection found with id: ${id}. The connection may not have been created properly`);
-        }
-        if (conn.status === vs_agent_model_1.ExtendedDidExchangeState.Completed)
+        if (!(conn === null || conn === void 0 ? void 0 : conn.id))
+            throw new Error(`No connection found with id: ${id}`);
+        if (conn.status === types_1.ConnectionStatus.Completed)
             return false;
-        const isMetadataValid = !conn.metadata || Object.keys(conn.metadata).length > 0;
-        const isLangValid = !requireLang || ((_a = conn.userProfile) === null || _a === void 0 ? void 0 : _a.preferredLanguage) != null;
-        if (isLangValid && isMetadataValid) {
-            this.updateStatus(conn.id, vs_agent_model_1.ExtendedDidExchangeState.Completed);
-            return true;
-        }
-        return false;
+        const completed = !requireProfile || ((_a = conn.userProfile) === null || _a === void 0 ? void 0 : _a.preferredLanguage) != null;
+        if (completed)
+            await this.updateStatus(conn.id, types_1.ConnectionStatus.Completed);
+        return completed;
     }
 };
 exports.ConnectionsRepository = ConnectionsRepository;

package/build/connections/connection.repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.repository.js","sourceRoot":"","sources":["../../src/connections/connection.repository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connection.repository.js","sourceRoot":"","sources":["../../src/connections/connection.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA2C;AAC3C,6CAAkD;AAElD,qCAAoC;AAEpC,oCAA2C;AAE3C,2DAAsD;AAG/C,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAEmB,UAAwC;QAAxC,eAAU,GAAV,UAAU,CAA8B;IACxD,CAAC;IAEG,KAAK,CAAC,MAAM,CAAC,UAAqC;QACvD,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAA;IAC7F,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,EAAU;;QAC9B,OAAO,MAAA,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,mCAAI,SAAS,CAAA;IACxE,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,MAAwB;;QAC5D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QAC3D,OAAO,CAAC,MAAA,MAAM,CAAC,QAAQ,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,EAAU,EAAE,WAAgC;QACzE,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAA;IACnD,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,cAAuB;;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,EAAE,CAAA;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAA;QACpE,IAAI,IAAI,CAAC,MAAM,KAAK,wBAAgB,CAAC,SAAS;YAAE,OAAO,KAAK,CAAA;QAE5D,MAAM,SAAS,GAAG,CAAC,cAAc,IAAI,CAAA,MAAA,IAAI,CAAC,WAAW,0CAAE,iBAAiB,KAAI,IAAI,CAAA;QAChF,IAAI,SAAS;YAAE,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,wBAAgB,CAAC,SAAS,CAAC,CAAA;QAC3E,OAAO,SAAS,CAAA;IAClB,CAAC;CACF,CAAA;AAhCY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,0BAAgB,EAAC,oCAAgB,CAAC,CAAA;qCACN,oBAAU;GAH9B,qBAAqB,CAgCjC"}

package/build/connections/connection.service.d.ts

@@ -1,23 +1,14 @@
-import { ConnectionStateUpdated } from '@verana-labs/vs-agent-model';
+import { ConnectionStateUpdatedData, ProfileReceivedData } from '@verana-labs/vs-agent-client';
 import { EventHandler } from '../interfaces';
-import { ConnectionEventOptions } from '../types';
+import { EventsModuleOptions } from '../types';
 import { ConnectionsRepository } from './connection.repository';
-export declare class ConnectionsEventService {
-    private options;
+export declare class ConnectionsService {
     private readonly repository;
-    private eventHandler?;
+    private readonly eventHandler;
     private readonly logger;
-    private readonly messageEvent;
-    constructor(options: ConnectionEventOptions, repository: ConnectionsRepository, eventHandler?: EventHandler | undefined);
-    update(event: ConnectionStateUpdated): Promise<any>;
-    /**
-     * Handles a new connection by verifying its completion status.
-     *
-     * If the connection is considered completed, it triggers the event handler
-     * and logs the connection initiation.
-     *
-     * @param connectionId The unique identifier of the connection.
-     * @returns A promise that resolves when the connection is processed.
-     */
+    private readonly requireProfile;
+    constructor(options: EventsModuleOptions, repository: ConnectionsRepository, eventHandler: EventHandler);
+    handleStateUpdated(data: ConnectionStateUpdatedData, timestamp: string): Promise<void>;
+    handleProfileReceived(data: ProfileReceivedData): Promise<void>;
     handleNewConnection(connectionId: string): Promise<void>;
 }