update TS types after changing End of these files: delegating.py, grouping.py, ipexing.py, notifying.py, exchanging.py

Sotatek-Patrick-Vu · Sotatek-Patrick-Vu · commit fa0c2ca2a220 · 2025-08-27T16:33:33.000+07:00
diff --git a/src/keri/app/contacting.ts b/src/keri/app/contacting.ts
@@ -189,9 +189,7 @@ export class Challenges {
     async responded(source: string, said: string): Promise<Operation<any>> {
         const path = `/challenges_verify/${source}`;
         const method = 'PUT';
-        const data = {
-            said: said,
-        };
+        const data = { said: said };
         const res = await this.client.fetch(path, method, data);
         // Check for empty response
         if (res.status === 204 || res.headers.get('content-length') === '0') {
diff --git a/src/keri/app/credentialing.ts b/src/keri/app/credentialing.ts
@@ -772,7 +772,7 @@ export class Ipex {
         exn: Serder,
         sigs: string[],
         recp: string[]
-    ): Promise<any> {
+    ): Promise<Operation<any>> {
         const body = {
             exn: exn.sad,
             sigs,
@@ -816,7 +816,7 @@ export class Ipex {
         sigs: string[],
         atc: string,
         recp: string[]
-    ): Promise<any> {
+    ): Promise<Operation<any>> {
         const body = {
             exn: exn.sad,
             sigs,
@@ -860,7 +860,7 @@ export class Ipex {
         exn: Serder,
         sigs: string[],
         recp: string[]
-    ): Promise<any> {
+    ): Promise<Operation<any>> {
         const body = {
             exn: exn.sad,
             sigs,
@@ -928,7 +928,7 @@ export class Ipex {
         sigs: string[],
         atc: string,
         recp: string[]
-    ): Promise<any> {
+    ): Promise<Operation<any>> {
         const body = {
             exn: exn.sad,
             sigs: sigs,
@@ -973,7 +973,7 @@ export class Ipex {
         sigs: string[],
         atc: string,
         recp: string[]
-    ): Promise<any> {
+    ): Promise<Operation<any>> {
         const body = {
             exn: exn.sad,
             sigs: sigs,
diff --git a/src/keri/app/exchanging.ts b/src/keri/app/exchanging.ts
@@ -6,6 +6,11 @@ import { Pather } from '../core/pather.ts';
 import { Counter, CtrDex } from '../core/counter.ts';
 import { Saider } from '../core/saider.ts';
 import { HabState } from '../core/keyState.ts';
+import { Exn } from './grouping.ts';
+import { components } from '../../types/keria-api-schema.ts';
+
+
+export type ExchangeResource = components["schemas"]["ExchangeResource"];
 
 /**
  * Exchanges
@@ -101,7 +106,7 @@ export class Exchanges {
     /**
      * Send exn messaget to list of recipients
      * @async
-     * @returns {Promise<any>} A promise to the list of replay messages
+     * @returns {Promise<Exn>} A promise to the list of replay messages
      * @param name
      * @param topic
      * @param exn
@@ -137,7 +142,7 @@ export class Exchanges {
      * @returns A promise to the exn message
      * @param said The said of the exn message
      */
-    async get(said: string): Promise<any> {
+    async get(said: string): Promise<ExchangeResource> {
         const path = `/exchanges/${said}`;
         const method = 'GET';
         const res = await this.client.fetch(path, method, null);
diff --git a/src/keri/app/grouping.ts b/src/keri/app/grouping.ts
@@ -1,5 +1,11 @@
 import { SignifyClient } from './clienting.ts';
 import { Dict } from '../core/core.ts';
+import { Operation } from './coring.ts';
+import { components } from '../../types/keria-api-schema.ts';
+
+
+export type Exn = components['schemas']['Exn'];
+export type ExnMultisig = components['schemas']['ExnMultisig'];
 
 /**
  * Groups
@@ -19,9 +25,9 @@ export class Groups {
      * Get group request messages
      * @async
      * @param {string} [said] SAID of exn message to load
-     * @returns {Promise<any>} A promise to the list of replay messages
+     * @returns {Promise<ExnMultisig[]>} A promise to the list of replay messages
      */
-    async getRequest(said: string): Promise<any> {
+    async getRequest(said: string): Promise<ExnMultisig[]> {
         const path = `/multisig/request/` + said;
         const method = 'GET';
         const res = await this.client.fetch(path, method, null);
@@ -35,14 +41,14 @@ export class Groups {
      * @param {Dict<any>} [exn] exn message to send to other members
      * @param {string[]} [sigs] signature of the participant over the exn
      * @param {string} [atc] additional attachments from embedded events in exn
-     * @returns {Promise<any>} A promise to the list of replay messages
+     * @returns {Promise<Exn>} A promise to the list of replay messages
      */
     async sendRequest(
         name: string,
         exn: Dict<any>,
         sigs: string[],
         atc: string
-    ): Promise<any> {
+    ): Promise<Exn> {
         const path = `/identifiers/${name}/multisig/request`;
         const method = 'POST';
         const data = {
@@ -64,7 +70,7 @@ export class Groups {
      * @param {string} [gid] prefix
      * @param {string[]} [smids] array of particpants
      * @param {string[]} [rmids] array of particpants
-     * @returns {Promise<any>} A promise to the list of replay messages
+     * @returns {Promise<Operation<any>} A promise to the list of replay messages
      */
     async join(
         name: string,
@@ -73,7 +79,7 @@ export class Groups {
         gid: string,
         smids: string[],
         rmids: string[]
-    ): Promise<any> {
+    ): Promise<Operation<any>> {
         const path = `/identifiers/${name}/multisig/join`;
         const method = 'POST';
         const data = {
diff --git a/src/keri/core/keyState.ts b/src/keri/core/keyState.ts
@@ -47,3 +47,9 @@ export type HabState =
     | GroupHabState
     | ExternHabState;
 
+export type Icp = components['schemas']['IcpV1'] | components['schemas']['IcpV2'];
+export type Ixn = components['schemas']['IxnV1'] | components['schemas']['IxnV2'];
+export type ExnV1 = components['schemas']['IxnV1'] | components['schemas']['ExnV2'];
+export type MultisigExnEmbeds = components['schemas']['MultisigExnEmbeds'];
+export type MultisigInceptEmbeds = components['schemas']['MultisigInceptEmbeds'];
+export type MultisigRpyEmbeds = components['schemas']['MultisigRpyEmbeds'];
diff --git a/src/types/keria-api-schema.ts b/src/types/keria-api-schema.ts
@@ -204,6 +204,8 @@ export interface components {
             b?: string[];
             c?: string[];
             a?: unknown;
+            /** @default  */
+            di: string;
         };
         RotV1: {
             /** @default  */
@@ -425,10 +427,10 @@ export interface components {
             q?: {
                 [key: string]: unknown;
             };
-            a?: unknown;
-            e?: {
+            a?: {
                 [key: string]: unknown;
             };
+            e?: components["schemas"]["ExnEmbeds"];
         };
         IssV1: {
             /** @default  */
@@ -524,6 +526,8 @@ export interface components {
             b?: string[];
             c?: string[];
             a?: unknown;
+            /** @default  */
+            di: string;
         };
         RotV2: {
             /** @default  */
@@ -735,7 +739,9 @@ export interface components {
             q?: {
                 [key: string]: unknown;
             };
-            a?: unknown;
+            a?: {
+                [key: string]: unknown;
+            };
         };
         StateEERecord: {
             /** @default 0 */
@@ -936,6 +942,76 @@ export interface components {
         AgentConfig: {
             iurls?: string[];
         };
+        Exn: components["schemas"]["ExnV1"] | components["schemas"]["ExnV2"];
+        Icp: components["schemas"]["IcpV1"] | components["schemas"]["IcpV2"];
+        Rot: components["schemas"]["RotV1"] | components["schemas"]["RotV2"];
+        Vcp: components["schemas"]["VcpV1"];
+        Iss: components["schemas"]["IssV1"];
+        Ixn: components["schemas"]["IxnV1"] | components["schemas"]["IxnV2"];
+        NotificationData: {
+            r: string;
+            /** @default null */
+            d: string | null;
+            /** @default null */
+            m: string | null;
+        };
+        Notification: {
+            i: string;
+            dt: string;
+            r: boolean;
+            a: components["schemas"]["NotificationData"];
+        };
+        ExchangeResource: {
+            exn: components["schemas"]["Exn"];
+            pathed: {
+                [key: string]: unknown;
+            };
+        };
+        MultisigInceptEmbeds: {
+            icp: components["schemas"]["Icp"];
+            rot?: components["schemas"]["Rot"];
+        };
+        MultisigRotateEmbeds: {
+            rot: unknown;
+        };
+        MultisigInteractEmbeds: {
+            ixn: components["schemas"]["Ixn"];
+        };
+        MultisigRegistryInceptEmbeds: {
+            vcp: components["schemas"]["Vcp"];
+            anc: components["schemas"]["ANC"];
+        };
+        MultisigIssueEmbeds: {
+            acdc: components["schemas"]["ACDC"];
+            iss: components["schemas"]["Iss"];
+            anc: components["schemas"]["ANC"];
+        };
+        MultisigRevokeEmbeds: {
+            rev: components["schemas"]["RevV1"];
+            anc: components["schemas"]["ANC"];
+        };
+        MultisigRpyEmbeds: {
+            rpy: components["schemas"]["Rpy"];
+        };
+        MultisigExnEmbeds: {
+            exn: components["schemas"]["Exn"];
+        };
+        ExnEmbeds: {
+            d: string;
+        } & (components["schemas"]["MultisigInceptEmbeds"] | components["schemas"]["MultisigRotateEmbeds"] | components["schemas"]["MultisigInteractEmbeds"] | components["schemas"]["MultisigRegistryInceptEmbeds"] | components["schemas"]["MultisigIssueEmbeds"] | components["schemas"]["MultisigRevokeEmbeds"] | components["schemas"]["MultisigRpyEmbeds"] | components["schemas"]["MultisigExnEmbeds"]);
+        ExnMultisig: {
+            exn: components["schemas"]["Exn"];
+            paths: {
+                [key: string]: unknown;
+            };
+            e: components["schemas"]["ExnEmbeds"];
+            /** @default null */
+            groupName: string | null;
+            /** @default null */
+            memberName: string | null;
+            /** @default null */
+            sender: string | null;
+        };
     };
     responses: never;
     parameters: never;
diff --git a/test-integration/credentials.test.ts b/test-integration/credentials.test.ts
@@ -344,9 +344,9 @@ test('single signature credentials', { timeout: 90000 }, async () => {
         const apply = await holderClient.exchanges().get(holderApplyNote.a.d);
         applySaid = apply.exn.d;
 
-        const filter: { [x: string]: any } = { '-s': apply.exn.a.s };
-        for (const key in apply.exn.a.a) {
-            filter[`-a-${key}`] = apply.exn.a.a[key];
+        const filter: { [x: string]: any } = { '-s': (apply.exn.a as any).s };
+        for (const key in (apply.exn.a as any).a) {
+            filter[`-a-${key}`] = (apply.exn.a as any).a[key];
         }
 
         const matchingCreds = await holderClient.credentials().list({ filter });
@@ -385,6 +385,18 @@ test('single signature credentials', { timeout: 90000 }, async () => {
         offerSaid = offer.exn.d;
 
         assert.strictEqual(offer.exn.p, applySaid);
+        assert(
+            'e' in offer.exn &&
+            offer.exn.e &&
+            typeof offer.exn.e === 'object' &&
+            'acdc' in offer.exn.e &&
+            offer.exn.e.acdc &&
+            typeof offer.exn.e.acdc === 'object' &&
+            'a' in offer.exn.e.acdc &&
+            offer.exn.e.acdc.a &&
+            typeof offer.exn.e.acdc.a === 'object' &&
+            'LEI' in offer.exn.e.acdc.a
+        );
         assert.strictEqual(offer.exn.e.acdc.a.LEI, '5493001KJTIIGC8Y1R17');
 
         await markAndRemoveNotification(verifierClient, verifierOfferNote);
diff --git a/test-integration/multisig-holder.test.ts b/test-integration/multisig-holder.test.ts
@@ -378,9 +378,20 @@ test('multisig', async function run() {
         exnRes.exn.i,
         recp
     );
-    console.log(
-        `Member1 admitted credential with SAID : ${exnRes.exn.e.acdc.d}`
-    );
+
+    if (
+        'e' in exnRes.exn &&
+        exnRes.exn.e &&
+        'acdc' in exnRes.exn.e &&
+        exnRes.exn.e.acdc &&
+        'd' in exnRes.exn.e.acdc
+    ) {
+        console.log(
+            `Member1 admitted credential with SAID : ${exnRes.exn.e.acdc.d}`
+        );
+    } else {
+        throw new Error('Expected property "e.acdc.d" not found on exnRes.exn');
+    }
 
     const grantMsgSaid2 = await waitAndMarkNotification(
         client2,
diff --git a/test-integration/multisig-join.test.ts b/test-integration/multisig-join.test.ts
@@ -98,7 +98,11 @@ describe('multisig-join', () => {
         const msgSaid = await waitAndMarkNotification(client2, '/multisig/icp');
 
         const response = await client2.groups().getRequest(msgSaid);
-        const icp = response[0].exn.e.icp;
+        const exn = response[0].exn;
+        if (!('e' in exn) || !exn.e || !('icp' in exn.e) || !exn.e.icp) {
+            throw new Error('exn.e.icp is missing from the group inception response');
+        }
+        const icp = exn.e.icp;
 
         const icpResult2 = await client2.identifiers().create(nameMultisig, {
             algo: signify.Algos.group,
@@ -331,13 +335,26 @@ describe('multisig-join', () => {
             .getRequest(rotationNotification3);
 
         const exn3 = response[0].exn;
+        if (!('e' in exn3) || !exn3.e || !('rot' in exn3.e) || !exn3.e.rot) {
+            throw new Error('exn3.e.rot is missing from the group rotation response');
+        }
+        if (!exn3.a || typeof (exn3.a as any).gid !== 'string') {
+            throw new Error('exn3.a.gid is missing or not a string');
+        }
         const serder3 = new Serder(exn3.e.rot);
         const keeper3 = await client3.manager!.get(aid3);
         const sigs3 = keeper3.sign(signify.b(serder3.raw));
 
         const joinOperation = await client3
             .groups()
-            .join(nameMultisig, serder3, sigs3, exn3.a.gid, smids, rmids);
+            .join(
+                nameMultisig,
+                serder3,
+                sigs3,
+                (exn3.a as { gid: string }).gid,
+                smids,
+                rmids
+            );
 
         await waitOperation(client3, joinOperation);
 
diff --git a/test-integration/multisig.test.ts b/test-integration/multisig.test.ts
diff --git a/test-integration/utils/multisig-utils.ts b/test-integration/utils/multisig-utils.ts
