@hashgraphonline/standards-sdk 0.0.84 → 0.0.86

package/dist/es/hcs-10/connections-manager.d.ts

@@ -37,6 +37,8 @@ export interface Connection {
     closedReason?: string;
     closeMethod?: string;
     uniqueRequestKey?: string;
+    originTopicId?: string;
+    processed: boolean;
 }
 /**
  * Options for the connections manager
@@ -46,11 +48,112 @@ export interface ConnectionsManagerOptions {
     filterPendingAccountIds?: string[];
     baseClient: HCS10BaseClient;
 }
+/**
+ * Defines the interface for a connections manager that handles HCS-10 connections
+ */
+export interface IConnectionsManager {
+    /**
+     * Fetches and processes connection data using the configured client
+     * @param accountId - The account ID to fetch connection data for
+     * @returns A promise that resolves to an array of Connection objects
+     */
+    fetchConnectionData(accountId: string): Promise<Connection[]>;
+    /**
+     * Process outbound messages to track connection requests and confirmations
+     * @param messages - The messages to process
+     * @param accountId - The account ID that sent the messages
+     * @returns Array of connections after processing
+     */
+    processOutboundMessages(messages: HCSMessage[], accountId: string): Connection[];
+    /**
+     * Process inbound messages to track connection requests and confirmations
+     * @param messages - The messages to process
+     * @returns Array of connections after processing
+     */
+    processInboundMessages(messages: HCSMessage[]): Connection[];
+    /**
+     * Process connection topic messages to update last activity time
+     * @param connectionTopicId - The topic ID of the connection
+     * @param messages - The messages to process
+     * @returns The updated connection or undefined if not found
+     */
+    processConnectionMessages(connectionTopicId: string, messages: HCSMessage[]): Connection | undefined;
+    /**
+     * Adds or updates profile information for a connection
+     * @param accountId - The account ID to add profile info for
+     * @param profile - The profile information
+     */
+    addProfileInfo(accountId: string, profile: any): void;
+    /**
+     * Gets all connections
+     * @returns Array of all connections that should be visible
+     */
+    getAllConnections(): Connection[];
+    /**
+     * Gets all pending connection requests
+     * @returns Array of pending connection requests
+     */
+    getPendingRequests(): Connection[];
+    /**
+     * Gets all active (established) connections
+     * @returns Array of active connections
+     */
+    getActiveConnections(): Connection[];
+    /**
+     * Gets all connections needing confirmation
+     * @returns Array of connections needing confirmation
+     */
+    getConnectionsNeedingConfirmation(): Connection[];
+    /**
+     * Gets a connection by its topic ID
+     * @param connectionTopicId - The topic ID to look up
+     * @returns The connection with the given topic ID, or undefined if not found
+     */
+    getConnectionByTopicId(connectionTopicId: string): Connection | undefined;
+    /**
+     * Gets a connection by account ID
+     * @param accountId - The account ID to look up
+     * @returns The connection with the given account ID, or undefined if not found
+     */
+    getConnectionByAccountId(accountId: string): Connection | undefined;
+    /**
+     * Gets all connections for a specific account ID
+     * @param accountId - The account ID to look up
+     * @returns Array of connections for the given account ID
+     */
+    getConnectionsByAccountId(accountId: string): Connection[];
+    /**
+     * Updates or adds a connection
+     * @param connection - The connection to update or add
+     */
+    updateOrAddConnection(connection: Connection): void;
+    /**
+     * Clears all tracked connections and requests
+     */
+    clearAll(): void;
+    /**
+     * Checks if a given connection request has been processed already
+     * This uses a combination of topic ID and request ID to uniquely identify requests
+     *
+     * @param inboundTopicId - The inbound topic ID where the request was received
+     * @param requestId - The sequence number (request ID)
+     * @returns True if this specific request has been processed, false otherwise
+     */
+    isConnectionRequestProcessed(inboundTopicId: string, requestId: number): boolean;
+    /**
+     * Marks a specific connection request as processed
+     *
+     * @param inboundTopicId - The inbound topic ID where the request was received
+     * @param requestId - The sequence number (request ID)
+     * @returns True if a matching connection was found and marked, false otherwise
+     */
+    markConnectionRequestProcessed(inboundTopicId: string, requestId: number): boolean;
+}
 /**
  * ConnectionsManager provides a unified way to track and manage HCS-10 connections
  * across different applications. It works with both frontend and backend implementations.
  */
-export declare class ConnectionsManager {
+export declare class ConnectionsManager implements IConnectionsManager {
     private logger;
     private connections;
     private pendingRequests;
@@ -72,6 +175,12 @@ export declare class ConnectionsManager {
      * that might not be visible in our local messages
      */
     private checkTargetInboundTopicsForConfirmations;
+    /**
+     * Checks target agents' inbound topics for confirmations of our outbound connection requests
+     * This complements checkTargetInboundTopicsForConfirmations by looking for confirmations
+     * that might have been sent to the target agent's inbound topic rather than our own
+     */
+    private checkOutboundRequestsForConfirmations;
     /**
      * Fetches profiles for all connected accounts
      * @param accountId - The account ID making the request
@@ -105,10 +214,9 @@ export declare class ConnectionsManager {
     /**
      * Process inbound messages to track connection requests and confirmations
      * @param messages - The messages to process
-     * @param accountId - The account ID that received the messages
      * @returns Array of connections after processing
      */
-    processInboundMessages(messages: HCSMessage[], accountId: string): Connection[];
+    processInboundMessages(messages: HCSMessage[]): Connection[];
     /**
      * Process connection topic messages to update last activity time
      * @param connectionTopicId - The topic ID of the connection
@@ -154,12 +262,6 @@ export declare class ConnectionsManager {
      * @returns The connection with the given topic ID, or undefined if not found
      */
     getConnectionByTopicId(connectionTopicId: string): Connection | undefined;
-    /**
-     * Gets a connection by request ID
-     * @param requestId - The request ID to look up
-     * @returns The connection with the given request ID, or undefined if not found
-     */
-    getConnection(requestId: number, inboundTopicId: string): Connection | undefined;
     /**
      * Gets a connection by account ID
      * @param accountId - The account ID to look up
@@ -181,5 +283,22 @@ export declare class ConnectionsManager {
      * Clears all tracked connections and requests
      */
     clearAll(): void;
+    /**
+     * Checks if a given connection request has been processed already
+     * This uses a combination of topic ID and request ID to uniquely identify requests
+     *
+     * @param inboundTopicId - The inbound topic ID where the request was received
+     * @param requestId - The sequence number (request ID)
+     * @returns True if this specific request has been processed, false otherwise
+     */
+    isConnectionRequestProcessed(inboundTopicId: string, requestId: number): boolean;
+    /**
+     * Marks a specific connection request as processed
+     *
+     * @param inboundTopicId - The inbound topic ID where the request was received
+     * @param requestId - The sequence number (request ID)
+     * @returns True if a matching connection was found and marked, false otherwise
+     */
+    markConnectionRequestProcessed(inboundTopicId: string, requestId: number): boolean;
 }
 //# sourceMappingURL=connections-manager.d.ts.map

package/dist/es/hcs-10/connections-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connections-manager.d.ts","sourceRoot":"","sources":["../../../src/hcs-10/connections-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connections-manager.d.ts","sourceRoot":"","sources":["../../../src/hcs-10/connections-manager.ts"],"names":[],"mappings":"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"}