@bind-protocol/sdk 0.8.0 → 0.9.0

package/README.md

@@ -18,13 +18,13 @@ const client = new BindClient({
 });
 
 // Submit a prove job
-const result = await client.submitProveJob('bind.mobility.riskband.v1', {
+const { jobId } = await client.submitProveJob('bind.mobility.riskband.v1', {
   signals: JSON.stringify(telemetryData),
   timestamp: new Date().toISOString(),
 });
 
 // Wait for completion
-const job = await client.waitForProveJob(result.data.jobId);
+const job = await client.waitForProveJob(jobId);
 
 if (job.status === 'completed') {
   console.log('Proof generated:', job.attestationId);
@@ -230,14 +230,10 @@ async function generateRiskCredential(vehicleTokenId: string) {
 
   // 3. Transform and submit prove job
   const inputs = dimo.toCircuitInputs(telemetry, 'bind.mobility.riskband.v1');
-  const result = await bind.submitProveJob('bind.mobility.riskband.v1', inputs);
-
-  if (!result.success) {
-    throw new Error(result.error);
-  }
+  const { jobId } = await bind.submitProveJob('bind.mobility.riskband.v1', inputs);
 
   // 4. Wait for proof generation
-  const job = await bind.waitForProveJob(result.data.jobId, {
+  const job = await bind.waitForProveJob(jobId, {
     onProgress: (j) => console.log(`Status: ${j.status}`),
   });
 
@@ -268,10 +264,10 @@ import type {
   ProveJobInputs,
   ProveJob,
   ProveJobSummary,
-  SubmitProveJobResponse,
-  GetProveJobResponse,
+  SubmitProveJobResult,
   ListProveJobsOptions,
-  ListProveJobsResponse,
+  Pagination,
+  PollOptions,
 
   // Credential types
   BindCredential,

package/dist/{adapter-LeDOUfnn.d.ts → adapter-J6D9MZJV.d.ts}

@@ -1,5 +1,5 @@
-import { D as DataAdapter } from './types-CXWgNPXN.js';
-import { a as ProveJobInputs } from './types-D5XJykY-.js';
+import { D as DataAdapter } from './types-D7Q7ymPa.js';
+import { c as ProveJobInputs } from './types-BcPssdQk.js';
 
 /**
  * DIMO Adapter Types

package/dist/{adapter-DBvPax2O.d.cts → adapter-qe9f1ll3.d.cts}

@@ -1,5 +1,5 @@
-import { D as DataAdapter } from './types-D-cTYE3o.cjs';
-import { a as ProveJobInputs } from './types-D5XJykY-.cjs';
+import { D as DataAdapter } from './types-ywkMNwun.cjs';
+import { c as ProveJobInputs } from './types-BcPssdQk.cjs';
 
 /**
  * DIMO Adapter Types

package/dist/adapters/dimo/index.d.cts

@@ -1,6 +1,6 @@
-export { D as DimoAdapter, a as DimoAdapterConfig, f as DimoClient, b as DimoQuery, e as DimoSignal, d as DimoTelemetryData, c as createDimoAdapter } from '../../adapter-DBvPax2O.cjs';
-import '../../types-D-cTYE3o.cjs';
-import '../../types-D5XJykY-.cjs';
+export { D as DimoAdapter, a as DimoAdapterConfig, f as DimoClient, b as DimoQuery, e as DimoSignal, d as DimoTelemetryData, c as createDimoAdapter } from '../../adapter-qe9f1ll3.cjs';
+import '../../types-ywkMNwun.cjs';
+import '../../types-BcPssdQk.cjs';
 import '@bind-protocol/policy-spec';
 
 /**

package/dist/adapters/dimo/index.d.ts

@@ -1,6 +1,6 @@
-export { D as DimoAdapter, a as DimoAdapterConfig, f as DimoClient, b as DimoQuery, e as DimoSignal, d as DimoTelemetryData, c as createDimoAdapter } from '../../adapter-LeDOUfnn.js';
-import '../../types-CXWgNPXN.js';
-import '../../types-D5XJykY-.js';
+export { D as DimoAdapter, a as DimoAdapterConfig, f as DimoClient, b as DimoQuery, e as DimoSignal, d as DimoTelemetryData, c as createDimoAdapter } from '../../adapter-J6D9MZJV.js';
+import '../../types-D7Q7ymPa.js';
+import '../../types-BcPssdQk.js';
 import '@bind-protocol/policy-spec';
 
 /**

package/dist/adapters/index.cjs

@@ -165,33 +165,42 @@ var BindClient = class {
    * @throws {InsufficientCreditsError} If there aren't enough credits
    */
   async submitProveJob(circuitId, inputs, options) {
-    const response = await this.fetch("/api/prove", {
-      method: "POST",
-      body: JSON.stringify({
-        circuitId,
-        inputs,
-        verificationMode: options?.verificationMode
-      })
-    });
-    const result = await response.json();
-    if (!result.success && result.requiredCredits !== void 0 && result.availableCredits !== void 0) {
-      throw new InsufficientCreditsError(result.requiredCredits, result.availableCredits);
+    try {
+      return await this.fetchJson("/api/prove", {
+        method: "POST",
+        body: JSON.stringify({
+          circuitId,
+          inputs,
+          verificationMode: options?.verificationMode
+        })
+      });
+    } catch (err) {
+      if (err instanceof ApiError && err.response) {
+        const body = err.response;
+        if (body.requiredCredits !== void 0 && body.availableCredits !== void 0) {
+          throw new InsufficientCreditsError(
+            body.requiredCredits,
+            body.availableCredits
+          );
+        }
+      }
+      throw err;
     }
-    return result;
   }
   /**
    * Get the status and results of a prove job
    * @param jobId - The unique job identifier
    * @returns The job details including status and outputs
+   * @throws {ApiError} If the API request fails
    */
   async getProveJob(jobId) {
-    const response = await this.fetch(`/api/prove/${encodeURIComponent(jobId)}`);
-    return response.json();
+    return this.fetchJson(`/api/prove/${encodeURIComponent(jobId)}`);
   }
   /**
    * List prove jobs for the authenticated organization
    * @param options - Optional filters for status, limit, and offset
    * @returns Paginated list of prove jobs
+   * @throws {ApiError} If the API request fails
    */
   async listProveJobs(options = {}) {
     const params = new URLSearchParams();
@@ -200,8 +209,7 @@ var BindClient = class {
     if (options.offset !== void 0) params.set("offset", options.offset.toString());
     const queryString = params.toString();
     const path = queryString ? `/api/prove?${queryString}` : "/api/prove";
-    const response = await this.fetch(path);
-    return response.json();
+    return this.fetchJson(path);
   }
   /**
    * Poll for prove job completion
@@ -209,21 +217,14 @@ var BindClient = class {
    * @param options - Polling options
    * @returns The completed or failed job
    * @throws {TimeoutError} If the job doesn't complete within the timeout
+   * @throws {ApiError} If the API request fails
    */
   async waitForProveJob(jobId, options = {}) {
     const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     const startTime = Date.now();
     while (Date.now() - startTime < timeoutMs) {
-      const result = await this.getProveJob(jobId);
-      if (!result.success || !result.data) {
-        throw new ApiError(
-          result.error || "Failed to get prove job",
-          500,
-          result
-        );
-      }
-      const job = result.data;
+      const job = await this.getProveJob(jobId);
       if (options.onProgress) {
         options.onProgress(job);
       }
@@ -243,41 +244,28 @@ var BindClient = class {
   /**
    * List all available public policies
    * @returns Array of public policy specifications
+   * @throws {ApiError} If the API request fails
    */
   async listPolicies() {
-    const response = await fetch(`${this.baseUrl}/api/policies`, {
-      method: "GET"
-    });
-    if (!response.ok) {
-      throw new ApiError(
-        `Failed to fetch policies: ${response.statusText}`,
-        response.status
-      );
-    }
-    const json = await response.json();
-    return json.data ?? json;
+    return this.fetchJson("/api/policies");
   }
   /**
    * Get a specific policy by ID
    * @param policyId - The unique policy identifier
    * @returns The public policy specification, or null if not found
+   * @throws {ApiError} If the API request fails (except 404)
    */
   async getPolicy(policyId) {
-    const response = await fetch(
-      `${this.baseUrl}/api/policies/${encodeURIComponent(policyId)}`,
-      { method: "GET" }
-    );
-    if (response.status === 404) {
-      return null;
-    }
-    if (!response.ok) {
-      throw new ApiError(
-        `Failed to fetch policy: ${response.statusText}`,
-        response.status
+    try {
+      return await this.fetchJson(
+        `/api/policies/${encodeURIComponent(policyId)}`
       );
+    } catch (err) {
+      if (err instanceof ApiError && err.status === 404) {
+        return null;
+      }
+      throw err;
     }
-    const json = await response.json();
-    return json.data ?? json;
   }
   // ==========================================================================
   // zkTLS Methods
@@ -285,49 +273,49 @@ var BindClient = class {
   /**
    * List available zkTLS extractors (data sources)
    * @returns Array of available extractors
+   * @throws {ApiError} If the API request fails
    */
   async listExtractors() {
-    const response = await this.fetch("/api/zktls/extractors");
-    return response.json();
+    return this.fetchJson("/api/zktls/extractors");
   }
   /**
    * List zkTLS attestations for the authenticated organization
    * @returns Array of attestations
+   * @throws {ApiError} If the API request fails
    */
   async listAttestations() {
-    const response = await this.fetch("/api/zktls/attestations");
-    return response.json();
+    return this.fetchJson("/api/zktls/attestations");
   }
   /**
    * Get a specific attestation by ID
    * @param attestationId - The attestation UUID
-   * @returns The attestation or null if not found
+   * @returns The attestation details
+   * @throws {ApiError} If the API request fails
    */
   async getAttestation(attestationId) {
-    const response = await this.fetch(`/api/zktls/attestations/${encodeURIComponent(attestationId)}`);
-    return response.json();
+    return this.fetchJson(`/api/zktls/attestations/${encodeURIComponent(attestationId)}`);
   }
   /**
    * Create a new zkTLS session for data attestation
    * @param extractorId - The extractor to use (e.g., "coinbase")
    * @param callbackUrl - URL to redirect to after authentication
    * @returns Session ID and auth URL to redirect user to
+   * @throws {ApiError} If the API request fails
    */
   async createZkTlsSession(extractorId, callbackUrl) {
-    const response = await this.fetch("/api/zktls/sessions", {
+    return this.fetchJson("/api/zktls/sessions", {
       method: "POST",
       body: JSON.stringify({ extractor: extractorId, callbackUrl })
     });
-    return response.json();
   }
   /**
    * Get the status of a zkTLS session
    * @param sessionId - The session UUID
    * @returns Session status and attestation if completed
+   * @throws {ApiError} If the API request fails
    */
   async getZkTlsSession(sessionId) {
-    const response = await this.fetch(`/api/zktls/sessions/${encodeURIComponent(sessionId)}`);
-    return response.json();
+    return this.fetchJson(`/api/zktls/sessions/${encodeURIComponent(sessionId)}`);
   }
   /**
    * Wait for a zkTLS session to complete
@@ -337,21 +325,14 @@ var BindClient = class {
    * @throws {ZkTlsSessionExpiredError} If session expires
    * @throws {ZkTlsSessionFailedError} If session fails
    * @throws {TimeoutError} If timeout is reached
+   * @throws {ApiError} If the API request fails
    */
   async waitForZkTlsSession(sessionId, options = {}) {
     const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     const startTime = Date.now();
     while (Date.now() - startTime < timeoutMs) {
-      const result = await this.getZkTlsSession(sessionId);
-      if (!result.success || !result.data) {
-        throw new ApiError(
-          result.error || "Failed to get zkTLS session",
-          500,
-          result
-        );
-      }
-      const session = result.data;
+      const session = await this.getZkTlsSession(sessionId);
       if (options.onProgress) {
         options.onProgress(session);
       }
@@ -378,6 +359,7 @@ var BindClient = class {
    * List available circuits
    * @param options - Optional filters
    * @returns Array of circuits
+   * @throws {ApiError} If the API request fails
    */
   async listCircuits(options = {}) {
     const params = new URLSearchParams();
@@ -385,28 +367,27 @@ var BindClient = class {
     if (options.policyId) params.set("policyId", options.policyId);
     const queryString = params.toString();
     const path = queryString ? `/api/circuits?${queryString}` : "/api/circuits";
-    const response = await this.fetch(path);
-    return response.json();
+    return this.fetchJson(path);
   }
   /**
    * Get a specific circuit by ID
    * @param circuitId - The circuit identifier
-   * @returns The circuit details or null if not found
+   * @returns The circuit details
+   * @throws {ApiError} If the API request fails
    */
   async getCircuit(circuitId) {
-    const response = await this.fetch(`/api/circuits/${encodeURIComponent(circuitId)}`);
-    return response.json();
+    return this.fetchJson(`/api/circuits/${encodeURIComponent(circuitId)}`);
   }
   /**
    * Activate a circuit (requires validation to have passed)
    * @param circuitId - The circuit identifier to activate
    * @returns The activation result
+   * @throws {ApiError} If the API request fails
    */
   async activateCircuit(circuitId) {
-    const response = await this.fetch(`/api/circuits/${encodeURIComponent(circuitId)}/activate`, {
+    return this.fetchJson(`/api/circuits/${encodeURIComponent(circuitId)}/activate`, {
       method: "POST"
     });
-    return response.json();
   }
   // ==========================================================================
   // Shared Proof Methods
@@ -415,18 +396,19 @@ var BindClient = class {
    * Share a completed proof with a verifier organization
    * @param request - Share proof request with proveJobId and verifierOrgId
    * @returns The created shared proof
+   * @throws {ApiError} If the API request fails
    */
   async shareProof(request) {
-    const response = await this.fetch("/api/shared-proofs", {
+    return this.fetchJson("/api/shared-proofs", {
       method: "POST",
       body: JSON.stringify(request)
     });
-    return response.json();
   }
   /**
    * List shared proofs (outgoing or incoming)
    * @param options - Filter by direction, pagination, and inclusion options
    * @returns Paginated list of shared proofs
+   * @throws {ApiError} If the API request fails
    */
   async listSharedProofs(options = {}) {
     const params = new URLSearchParams();
@@ -437,28 +419,27 @@ var BindClient = class {
     if (options.includeRevoked) params.set("includeRevoked", "true");
     const queryString = params.toString();
     const path = queryString ? `/api/shared-proofs?${queryString}` : "/api/shared-proofs";
-    const response = await this.fetch(path);
-    return response.json();
+    return this.fetchJson(path);
   }
   /**
    * Get a specific shared proof by ID
    * @param sharedProofId - The shared proof ID
    * @returns The shared proof details
+   * @throws {ApiError} If the API request fails
    */
   async getSharedProof(sharedProofId) {
-    const response = await this.fetch(`/api/shared-proofs/${encodeURIComponent(sharedProofId)}`);
-    return response.json();
+    return this.fetchJson(`/api/shared-proofs/${encodeURIComponent(sharedProofId)}`);
   }
   /**
    * Revoke a shared proof. Only the sharing organization can revoke.
    * @param sharedProofId - The shared proof ID to revoke
    * @returns The revocation result
+   * @throws {ApiError} If the API request fails
    */
   async revokeSharedProof(sharedProofId) {
-    const response = await this.fetch(`/api/shared-proofs/${encodeURIComponent(sharedProofId)}`, {
+    return this.fetchJson(`/api/shared-proofs/${encodeURIComponent(sharedProofId)}`, {
       method: "DELETE"
     });
-    return response.json();
   }
   // ==========================================================================
   // Verification Methods
@@ -472,84 +453,70 @@ var BindClient = class {
    * @param sharedProofId - The shared proof ID to verify
    * @param options - Optional polling configuration
    * @returns The verification result
+   * @throws {ApiError} If the API request fails
+   * @throws {TimeoutError} If verification doesn't complete within the timeout
    */
   async verifySharedProof(sharedProofId, options) {
-    const pollIntervalMs = options?.pollIntervalMs ?? 1e3;
-    const maxWaitMs = options?.maxWaitMs ?? 12e4;
-    const queueResponse = await this.fetch(`/api/verify/shared/${encodeURIComponent(sharedProofId)}`, {
+    const intervalMs = options?.intervalMs ?? 1e3;
+    const timeoutMs = options?.timeoutMs ?? 12e4;
+    const queueResult = await this.fetchJson(`/api/verify/shared/${encodeURIComponent(sharedProofId)}`, {
       method: "POST"
     });
-    const queueResult = await queueResponse.json();
-    if (!queueResult.success || !queueResult.data?.jobId) {
-      return {
-        success: false,
-        error: queueResult.error ?? "Failed to queue verification job"
-      };
-    }
-    const jobId = queueResult.data.jobId;
+    const jobId = queueResult.jobId;
     const startTime = Date.now();
-    while (Date.now() - startTime < maxWaitMs) {
+    while (Date.now() - startTime < timeoutMs) {
       const statusResult = await this.getVerifyJobStatus(jobId);
-      if (!statusResult.success) {
-        return {
-          success: false,
-          error: statusResult.error ?? "Failed to get verification status"
-        };
-      }
-      const status = statusResult.data?.status;
-      if (status === "completed" || status === "failed") {
+      if (statusResult.status === "completed" || statusResult.status === "failed") {
         return {
-          success: true,
-          data: {
-            isValid: statusResult.data?.isValid ?? false,
-            error: statusResult.data?.error,
-            verificationTimeMs: statusResult.data?.verificationTimeMs ?? 0,
-            creditsCharged: statusResult.data?.creditsCharged ?? queueResult.data.creditsCharged,
-            verificationResultId: statusResult.data?.verificationResultId ?? jobId,
-            publicInputs: statusResult.data?.publicInputs
-          }
+          isValid: statusResult.isValid ?? false,
+          error: statusResult.error,
+          verificationTimeMs: statusResult.verificationTimeMs ?? 0,
+          creditsCharged: statusResult.creditsCharged ?? queueResult.creditsCharged,
+          verificationResultId: statusResult.verificationResultId ?? jobId,
+          publicInputs: statusResult.publicInputs
         };
       }
-      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+      await this.sleep(intervalMs);
     }
-    return {
-      success: false,
-      error: `Verification timed out after ${maxWaitMs}ms. Job ID: ${jobId}`
-    };
+    throw new TimeoutError(
+      `Verification timed out after ${timeoutMs}ms. Job ID: ${jobId}`,
+      timeoutMs
+    );
   }
   /**
    * Get the status of a verification job
    * @param jobId - The verification job ID
-   * @returns The job status
+   * @returns The job status data
+   * @throws {ApiError} If the API request fails
    */
   async getVerifyJobStatus(jobId) {
-    const response = await this.fetch(`/api/verify/jobs/${encodeURIComponent(jobId)}`);
-    return response.json();
+    return this.fetchJson(`/api/verify/jobs/${encodeURIComponent(jobId)}`);
   }
   /**
    * Verify an uploaded proof
    * @param proofBuffer - The proof binary as ArrayBuffer, Uint8Array, or Buffer
    * @param vkBuffer - The verification key binary as ArrayBuffer, Uint8Array, or Buffer
    * @returns The verification result
+   * @throws {ApiError} If the API request fails
    */
   async verifyUploadedProof(proofBuffer, vkBuffer) {
     const proofBytes = proofBuffer instanceof Uint8Array ? proofBuffer : new Uint8Array(proofBuffer);
     const vkBytes = vkBuffer instanceof Uint8Array ? vkBuffer : new Uint8Array(vkBuffer);
     const proofBase64 = typeof Buffer !== "undefined" ? Buffer.from(proofBytes).toString("base64") : btoa(String.fromCharCode(...proofBytes));
     const vkBase64 = typeof Buffer !== "undefined" ? Buffer.from(vkBytes).toString("base64") : btoa(String.fromCharCode(...vkBytes));
-    const response = await this.fetch("/api/verify/upload", {
+    return this.fetchJson("/api/verify/upload", {
       method: "POST",
       body: JSON.stringify({
         proof: proofBase64,
         vk: vkBase64
       })
     });
-    return response.json();
   }
   /**
    * Get verification history for the authenticated organization
    * @param options - Pagination options
    * @returns Paginated list of verification results
+   * @throws {ApiError} If the API request fails
    */
   async getVerificationHistory(options = {}) {
     const params = new URLSearchParams();
@@ -557,8 +524,7 @@ var BindClient = class {
     if (options.offset !== void 0) params.set("offset", options.offset.toString());
     const queryString = params.toString();
     const path = queryString ? `/api/verify/history?${queryString}` : "/api/verify/history";
-    const response = await this.fetch(path);
-    return response.json();
+    return this.fetchJson(path);
   }
   // ==========================================================================
   // Private Helpers
@@ -574,8 +540,24 @@ var BindClient = class {
     if (response.status === 401) {
       throw new AuthenticationError();
     }
+    if (!response.ok) {
+      const body = await response.json().catch(() => ({}));
+      throw new ApiError(
+        body.error || `HTTP ${response.status}: ${response.statusText}`,
+        response.status,
+        body
+      );
+    }
     return response;
   }
+  async fetchJson(path, init) {
+    const response = await this.fetch(path, init);
+    const json = await response.json();
+    if (json.success === false) {
+      throw new ApiError(json.error || "Request failed", response.status, json);
+    }
+    return json.data ?? json;
+  }
   sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
@@ -613,11 +595,7 @@ var ZkTlsAdapter = class {
    * Client should redirect user to this URL
    */
   async createSession(callbackUrl) {
-    const result = await this.client.createZkTlsSession(this.extractorId, callbackUrl);
-    if (!result.success || !result.data) {
-      throw new Error(result.error || "Failed to create zkTLS session");
-    }
-    return result.data;
+    return this.client.createZkTlsSession(this.extractorId, callbackUrl);
   }
   /**
    * Wait for session completion and return attestation
@@ -628,7 +606,7 @@ var ZkTlsAdapter = class {
       throw new Error("Session completed but no attestation found");
     }
     const extractors = await this.client.listExtractors();
-    const extractor = extractors.data?.find((e) => e.id === this.extractorId);
+    const extractor = extractors.find((e) => e.id === this.extractorId);
     if (!extractor) {
       throw new Error(`Extractor not found: ${this.extractorId}`);
     }
@@ -641,17 +619,14 @@ var ZkTlsAdapter = class {
   // Protected helpers
   // ===========================================================================
   async fetchExistingAttestation(attestationId) {
-    const result = await this.client.getAttestation(attestationId);
-    if (!result.success || !result.data) {
-      throw new Error(result.error || "Attestation not found");
-    }
+    const attestation = await this.client.getAttestation(attestationId);
     const extractors = await this.client.listExtractors();
-    const extractor = extractors.data?.find((e) => e.id === result.data.extractor);
+    const extractor = extractors.find((e) => e.id === attestation.extractor);
     if (!extractor) {
-      throw new Error(`Extractor not found: ${result.data.extractor}`);
+      throw new Error(`Extractor not found: ${attestation.extractor}`);
     }
     return {
-      attestation: result.data,
+      attestation,
       extractor
     };
   }