@agentidcard/sdk 1.0.0 → 1.2.0

package/index.d.ts

@@ -71,6 +71,27 @@ export interface ReputationQueryParams {
   dimension?: string;
 }
 
+export interface ClientRegistrationOptions {
+  name: string;
+  allowed_origins: string[];
+  redirect_uris: string[];
+  admin_api_key: string;
+}
+
+export interface AuthCodeExchangeOptions {
+  code: string;
+  client_id: string;
+  client_secret: string;
+  origin?: string;
+}
+
+export interface QuickVerifyOptions {
+  token: string;
+  client_id: string;
+  client_secret: string;
+  origin?: string;
+}
+
 export declare class AilClient {
   constructor(options?: AilClientOptions);
   registerOwner(options: { email: string; org?: string }): Promise<OwnerRegistrationResponse>;
@@ -92,6 +113,15 @@ export declare class AilClient {
     private_key_jwk: Jwk;
   }): Promise<Record<string, unknown>>;
   verify(token: string): Promise<Record<string, unknown>>;
+  getAuthUrl(options: {
+    client_id: string;
+    redirect_uri: string;
+    scope?: string;
+    state?: string;
+  }): string;
+  registerClient(options: ClientRegistrationOptions): Promise<Record<string, unknown>>;
+  exchangeAuthCode(options: AuthCodeExchangeOptions): Promise<Record<string, unknown>>;
+  verifyQuick(options: QuickVerifyOptions): Promise<Record<string, unknown>>;
   verifyOffline(token: string): Promise<OfflineVerificationResult>;
   getPublicKeys(): Promise<Record<string, unknown>>;
   getReputation(ailId: string): Promise<Record<string, unknown>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentidcard/sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Official JavaScript SDK for Agent ID Card - AI agent identity credentials",
   "type": "module",
   "main": "./index.mjs",

package/src/client.mjs

@@ -22,10 +22,10 @@ export class AilClient {
     return query ? `${path}?${query}` : path;
   }
 
-  async #post(path, body) {
+  async #post(path, body, headers = {}) {
     const res = await fetch(`${this.serverUrl}${path}`, {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: { "Content-Type": "application/json", ...headers },
       body: JSON.stringify(body),
     });
     const data = await res.json();
@@ -38,10 +38,16 @@ export class AilClient {
     return data;
   }
 
-  async #get(path) {
-    const res = await fetch(`${this.serverUrl}${path}`);
-    if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    return res.json();
+  async #get(path, headers = {}) {
+    const res = await fetch(`${this.serverUrl}${path}`, { headers });
+    const data = await res.json();
+    if (!res.ok) {
+      const err = new Error(data.message ?? data.error ?? `HTTP ${res.status}`);
+      err.code = data.error;
+      err.status = res.status;
+      throw err;
+    }
+    return data;
   }
 
   // -------------------------------------------------------------------------
@@ -130,6 +136,39 @@ export class AilClient {
     return this.#post("/verify", { token });
   }
 
+  getAuthUrl({ client_id, redirect_uri, scope = "identity", state = "" }) {
+    const params = new URLSearchParams({
+      client_id,
+      redirect_uri,
+      scope,
+      state,
+    });
+    return `${this.serverUrl}/auth/verify?${params}`;
+  }
+
+  async registerClient({ name, allowed_origins, redirect_uris, admin_api_key }) {
+    return this.#post("/auth/clients/register", {
+      name,
+      allowed_origins,
+      redirect_uris,
+    }, {
+      "X-Admin-Key": admin_api_key,
+    });
+  }
+
+  async exchangeAuthCode({ code, client_id, client_secret, origin }) {
+    const headers = {};
+    if (origin) headers.Origin = origin;
+    return this.#post("/auth/exchange", { code, client_id, client_secret }, headers);
+  }
+
+  async verifyQuick({ token, client_id, client_secret, origin }) {
+    const path = this.#withQuery("/auth/verify-quick", { token, client_id });
+    const headers = { Authorization: `Bearer ${client_secret}` };
+    if (origin) headers.Origin = origin;
+    return this.#get(path, headers);
+  }
+
   /**
    * Verify a credential offline using the server's public key.
    * Fetches the JWKS once and caches it.