chore: remove any type in app directory

.gitignore

@@ -7,3 +7,4 @@ dist
 # IntelliJ Project Files
 .idea
 coverage/*
+

README.md

@@ -45,6 +45,12 @@ Typescript source files needs to be transpiled before running scripts or integra
     npm run build
     ```
 
+    To build and generate TypeScript types from KERIA OpenAPI docs dynamically
+
+    ```
+    SPEC_URL=http://localhost:3902/spec.yaml npm run build
+    ```
+
 - ready() must be called before library is useable. Example minimum viable client code.
 
     ```javascript

package.json

@@ -31,7 +31,8 @@
   ],
   "scripts": {
     "start": "npm run build -- --watch",
-    "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.json --noEmit",
+    "generate:types": "node scripts/generate-types.js",
+    "build": "npm run generate:types && tsc -p tsconfig.build.json && tsc -p tsconfig.json --noEmit",
     "test": "vitest",
     "prepare": "tsc -p tsconfig.build.json",
     "test:integration": "vitest -c vitest.integration.ts",

scripts/generate-types.js

@@ -0,0 +1,36 @@
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+
+const specUrl = process.env.SPEC_URL;
+const outputFile = path.resolve('src/types/keria-api-schema.ts');
+
+if (!specUrl) {
+    console.log('⚠️  Skipping OpenAPI type generation: SPEC_URL is not set.');
+    process.exit(0);
+}
+
+console.log(`📦 Generating types from ${specUrl}`);
+execSync(`npx openapi-typescript "${specUrl}" --output ${outputFile} --enum`, {
+    stdio: 'inherit',
+});
+
+// Read the full file
+const fullContent = fs.readFileSync(outputFile, 'utf8');
+
+// Extract the `export interface components { ... }` block
+const componentsMatch = fullContent.match(/export interface components \{[\s\S]+?\n\}/);
+
+// Extract all `export enum ... { ... }` blocks
+const enumMatches = [...fullContent.matchAll(/export enum [\w\d_]+ \{[\s\S]+?\n\}/g)];
+
+if (!componentsMatch) {
+    console.error("❌ Could not find 'export interface components' block.");
+    process.exit(1);
+}
+
+// Combine the interface and enums
+const enumsText = enumMatches.map(m => m[0]).join('\n\n');
+const cleaned = `// AUTO-GENERATED: Only components and enums retained from OpenAPI schema\n\n${enumsText}\n\n${componentsMatch[0]}\n`;
+
+fs.writeFileSync(outputFile, cleaned, 'utf8');

src/keri/app/aiding.ts

@@ -1,13 +1,22 @@
-import { Tier } from '../core/salter.ts';
-import { Algos } from '../core/manager.ts';
-import { incept, interact, reply, rotate } from '../core/eventing.ts';
+import { components } from '../../types/keria-api-schema.ts';
 import { b, Ilks, Serials, Vrsn_1_0 } from '../core/core.ts';
-import { Tholder } from '../core/tholder.ts';
+import {
+    EndRoleAddAttributes,
+    incept,
+    interact,
+    InteractEventSAD,
+    reply,
+    rotate,
+    SealSourceTriple,
+} from '../core/eventing.ts';
+import { parseRangeHeaders } from '../core/httping.ts';
+import { IdentifierManagerFactory, SignResult } from '../core/keeping.ts';
+import { HabState, KeyState } from '../core/keyState.ts';
+import { Algos } from '../core/manager.ts';
 import { MtrDex } from '../core/matter.ts';
+import { Tier } from '../core/salter.ts';
 import { Serder } from '../core/serder.ts';
-import { parseRangeHeaders } from '../core/httping.ts';
-import { IdentifierManagerFactory } from '../core/keeping.ts';
-import { HabState } from '../core/keyState.ts';
+import { Tholder } from '../core/tholder.ts';
 
 /** Arguments required to create an identfier */
 export interface CreateIdentiferArgs {
@@ -19,13 +28,13 @@ export interface CreateIdentiferArgs {
     proxy?: string;
     delpre?: string;
     dcode?: string;
-    data?: any;
+    data?: Record<string, unknown>[];
     algo?: Algos;
     pre?: string;
-    states?: any[];
-    rstates?: any[];
-    prxs?: any[];
-    nxts?: any[];
+    states?: KeyState[];
+    rstates?: KeyState[];
+    prxs?: string[];
+    nxts?: string[];
     mhab?: HabState;
     keys?: string[];
     ndigs?: string[];
@@ -34,7 +43,7 @@ export interface CreateIdentiferArgs {
     ncount?: number;
     tier?: Tier;
     extern_type?: string;
-    extern?: any;
+    extern?: Record<string, unknown>;
 }
 
 /** Arguments required to rotate an identfier */
@@ -48,8 +57,8 @@ export interface RotateIdentifierArgs {
     ncode?: string;
     ncount?: number;
     ncodes?: string[];
-    states?: any[];
-    rstates?: any[];
+    states?: KeyState[];
+    rstates?: KeyState[];
 }
 
 /**
@@ -73,6 +82,8 @@ export interface IdentifierInfo {
     name: string;
 }
 
+export type GroupMember = components['schemas']['GroupMember'];
+
 /** Identifier */
 export class Identifier {
     public client: IdentifierDeps;
@@ -92,7 +103,15 @@ export class Identifier {
      * @param {number} [end=24] End index of list of notifications, defaults to 24
      * @returns {Promise<any>} A promise to the list of managed identifiers
      */
-    async list(start: number = 0, end: number = 24): Promise<any> {
+    async list(
+        start: number = 0,
+        end: number = 24
+    ): Promise<{
+        start: number;
+        end: number;
+        total: number;
+        aids: any;
+    }> {
         const extraHeaders = new Headers();
         extraHeaders.append('Range', `aids=${start}-${end}`);
 
@@ -249,7 +268,7 @@ export class Identifier {
         }
 
         const sigs = await keeper!.sign(b(serder.raw));
-        const jsondata: any = {
+        const jsondata: Record<string, unknown> = {
             name: name,
             icp: serder.sad,
             sigs: sigs,
@@ -277,7 +296,10 @@ export class Identifier {
      * @param {any} [data] Option data to be anchored in the interaction event
      * @returns {Promise<EventResult>} A promise to the interaction event result
      */
-    async interact(name: string, data?: any): Promise<EventResult> {
+    async interact(
+        name: string,
+        data?: SealSourceTriple[] | SealSourceTriple
+    ): Promise<EventResult> {
         const { serder, sigs, jsondata } = await this.createInteract(
             name,
             data
@@ -293,16 +315,20 @@ export class Identifier {
 
     async createInteract(
         name: string,
-        data?: any
-    ): Promise<{ serder: any; sigs: any; jsondata: any }> {
+        data?: SealSourceTriple[] | SealSourceTriple
+    ): Promise<{
+        serder: Serder<InteractEventSAD>;
+        sigs: SignResult;
+        jsondata: Record<string, unknown>;
+    }> {
         const hab = await this.get(name);
         const pre: string = hab.prefix;
 
         const state = hab.state;
         const sn = parseInt(state.s, 16);
         const dig = state.d;
 
-        data = Array.isArray(data) ? data : [data];
+        data = Array.isArray(data) ? data : ([data] as SealSourceTriple[]);
 
         const serder = interact({
             pre: pre,
@@ -315,7 +341,7 @@ export class Identifier {
         const keeper = this.client!.manager!.get(hab);
         const sigs = await keeper.sign(b(serder.raw));
 
-        const jsondata: any = {
+        const jsondata: Record<string, unknown> = {
             ixn: serder.sad,
             sigs: sigs,
         };
@@ -399,7 +425,7 @@ export class Identifier {
 
         const sigs = await keeper.sign(b(serder.raw));
 
-        const jsondata: any = {
+        const jsondata: Record<string, unknown> = {
             rot: serder.sad,
             sigs: sigs,
             smids:
@@ -472,7 +498,7 @@ export class Identifier {
         eid?: string,
         stamp?: string
     ): Serder {
-        const data: any = {
+        const data: EndRoleAddAttributes = {
             cid: pre,
             role: role,
         };
@@ -487,9 +513,9 @@ export class Identifier {
      * Get the members of a group identifier
      * @async
      * @param {string} name - Name or alias of the identifier
-     * @returns {Promise<any>} - A promise to the list of members
+     * @returns {Promise<GroupMember>} - A promise to the list of members
      */
-    async members(name: string): Promise<any> {
+    async members(name: string): Promise<GroupMember> {
         const res = await this.client.fetch(
             '/identifiers/' + name + '/members',
             'GET',

src/keri/app/clienting.ts

@@ -1,12 +1,14 @@
+import { components } from '../../types/keria-api-schema.ts';
 import { Authenticater } from '../core/authing.ts';
 import { HEADER_SIG_TIME } from '../core/httping.ts';
 import { ExternalModule, IdentifierManagerFactory } from '../core/keeping.ts';
+import { KeyState } from '../core/keyState.ts';
 import { Tier } from '../core/salter.ts';
 
 import { Identifier } from './aiding.ts';
-import { Contacts, Challenges } from './contacting.ts';
-import { Agent, Controller } from './controller.ts';
-import { Oobis, Operations, KeyEvents, KeyStates, Config } from './coring.ts';
+import { Challenges, Contacts } from './contacting.ts';
+import { Agent, Controller, RotateAID } from './controller.ts';
+import { Config, KeyEvents, KeyStates, Oobis, Operations } from './coring.ts';
 import { Credentials, Ipex, Registries, Schemas } from './credentialing.ts';
 import { Delegations } from './delegating.ts';
 import { Escrows } from './escrowing.ts';
@@ -16,9 +18,14 @@ import { Notifications } from './notifying.ts';
 
 const DEFAULT_BOOT_URL = 'http://localhost:3903';
 
-class State {
-    agent: any | null;
-    controller: any | null;
+// Export type outside the class
+export type AgentResourceResult = components["schemas"]["AgentResourceResult"];
+
+export type StateController  = components["schemas"]["Controller"];
+
+export class State {
+    agent: KeyState | null;
+    controller: StateController | null;
     ridx: number;
     pidx: number;
 
@@ -117,7 +124,7 @@ export class SignifyClient {
             throw new Error(`agent does not exist for controller ${caid}`);
         }
 
-        const data = await res.json();
+        const data = await res.json() as AgentResourceResult;
         const state = new State();
         state.agent = data.agent ?? {};
         state.controller = data.controller ?? {};
@@ -141,13 +148,13 @@ export class SignifyClient {
         );
         this.controller.ridx = state.ridx !== undefined ? state.ridx : 0;
         // Create agent representing the AID of KERIA cloud agent
-        this.agent = new Agent(state.agent);
+        this.agent = new Agent(state.agent!);
         if (this.agent.anchor != this.controller.pre) {
             throw Error(
                 'commitment to controller AID missing in agent inception event'
             );
         }
-        if (this.controller.serder.sad.s == 0) {
+        if (Number(this.controller.serder.sad.s) == 0) {
             await this.approveDelegation();
         }
         this.manager = new IdentifierManagerFactory(
@@ -172,7 +179,7 @@ export class SignifyClient {
     async fetch(
         path: string,
         method: string,
-        data: any,
+        data: unknown | null | undefined,
         extraHeaders?: Headers
     ): Promise<Response> {
         const headers = new Headers();
@@ -343,7 +350,7 @@ export class SignifyClient {
      * @param {Array<string>} aids List of managed AIDs to be rotated
      * @returns {Promise<Response>} A promise to the result of the rotation
      */
-    async rotate(nbran: string, aids: string[]): Promise<Response> {
+    async rotate(nbran: string, aids: RotateAID[]): Promise<Response> {
         const data = this.controller.rotate(nbran, aids);
         return await fetch(this.url + '/agent/' + this.controller.pre, {
             method: 'PUT',

src/keri/app/contacting.ts

@@ -1,12 +1,9 @@
 import { SignifyClient } from './clienting.ts';
 import { Operation } from './coring.ts';
+import { components } from '../../types/keria-api-schema.ts';
 
-export interface Contact {
-    alias: string;
-    oobi: string;
-    id: string;
-    [key: string]: unknown;
-}
+
+export type Contact = components['schemas']['Contact'];
 
 export interface ContactInfo {
     [key: string]: unknown;
@@ -111,9 +108,7 @@ export class Contacts {
     }
 }
 
-export interface Challenge {
-    words: string[];
-}
+export type Challenge = components['schemas']['Challenge'];
 
 /**
  * Challenges
@@ -189,15 +184,15 @@ export class Challenges {
      * Mark challenge response as signed and accepted
      * @param source Prefix of the identifier that was challenged
      * @param said qb64 AID of exn message representing the signed response
-     * @returns {Promise<Response>} A promise to the result
+     * @returns {Promise<Operation<any>>} A promise to the result
      */
-    async responded(source: string, said: string): Promise<Response> {
+    async responded(source: string, said: string): Promise<Operation<any>> {
         const path = `/challenges_verify/${source}`;
         const method = 'PUT';
         const data = {
             said: said,
         };
         const res = await this.client.fetch(path, method, data);
-        return res;
+        return await res.json() as Operation<any>;
     }
 }