hiloop-sdk 0.6.0 → 0.7.0

package/dist/client.d.ts

@@ -842,6 +842,17 @@ export declare class HiloopClient {
     }>;
     /** Decrypt an encrypted session message (e.g., from a webhook payload). */
     decryptSessionMessage(encryptedContent: string): Promise<string | null>;
+    /**
+     * Decrypt an interaction webhook payload in place.
+     * Decrypts encryptedTitle, encryptedResponse, encryptedComment using contentWrappings.
+     * Returns the payload with added `title`, `response`, `comment` fields.
+     */
+    decryptWebhookPayload<T extends Record<string, unknown>>(payload: T): Promise<T & {
+        title?: string;
+        response?: string;
+        comment?: string;
+        content?: string;
+    }>;
     static generateKeyPair(): KeyPair;
     /** Encrypt plaintext with AES-256-GCM for session messages. */
     static encryptAes(plaintext: string, keyBase64: string): Promise<string>;

package/dist/client.js

@@ -1237,6 +1237,33 @@ export class HiloopClient {
         await this.ensureInitialized();
         return this.crypto.decryptSessionMessage(encryptedContent);
     }
+    /**
+     * Decrypt an interaction webhook payload in place.
+     * Decrypts encryptedTitle, encryptedResponse, encryptedComment using contentWrappings.
+     * Returns the payload with added `title`, `response`, `comment` fields.
+     */
+    async decryptWebhookPayload(payload) {
+        await this.ensureInitialized();
+        const result = { ...payload };
+        const wrappings = payload.contentWrappings;
+        // Session message
+        if (typeof payload.encryptedContent === "string") {
+            const plain = await this.crypto.decryptSessionMessage(payload.encryptedContent);
+            if (plain !== null)
+                result.content = plain;
+        }
+        // Interaction fields (need content wrappings)
+        if (wrappings?.length) {
+            for (const [encrypted, decrypted] of [["encryptedTitle", "title"], ["encryptedResponse", "response"], ["encryptedComment", "comment"]]) {
+                if (typeof payload[encrypted] === "string") {
+                    const plain = await this.crypto.decryptWrappedContent(payload[encrypted], wrappings);
+                    if (plain !== null)
+                        result[decrypted] = plain;
+                }
+            }
+        }
+        return result;
+    }
     // -- Crypto -----------------------------------------------------------------
     static generateKeyPair() {
         return generateKeyPair();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiloop-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "TypeScript SDK for Hiloop — zero-trust human-AI agent interaction platform",
   "type": "module",
   "main": "dist/index.js",