@bind-protocol/sdk 0.7.0 → 0.9.0

package/dist/core/index.d.cts

@@ -1,5 +1,5 @@
-export { B as BindClient, d as deriveCircuitId } from '../client-BkohyCGJ.cjs';
-export { A as ActivateCircuitResponse, B as BindClientOptions, l as BindCredential, i as Circuit, C as CircuitStatus, h as CircuitValidationStatus, t as CreateSessionResponse, s as GetAttestationResponse, k as GetCircuitResponse, G as GetProveJobResponse, u as GetSessionResponse, D as GetSharedProofResponse, O as GetVerificationHistoryOptions, Q as GetVerificationHistoryResponse, r as ListAttestationsResponse, j as ListCircuitsResponse, q as ListExtractorsResponse, L as ListProveJobsOptions, g as ListProveJobsResponse, y as ListSharedProofsOptions, z as ListSharedProofsResponse, c as ProofDownloadUrls, d as ProveJob, a as ProveJobInputs, b as ProveJobOutputs, P as ProveJobStatus, e as ProveJobSummary, R as RevokeSharedProofResponse, w as ShareProofRequest, x as ShareProofResponse, v as SharedProof, S as SubmitProveJobRequest, f as SubmitProveJobResponse, N as VerificationHistoryEntry, V as VerificationMode, I as VerificationResult, F as VerifyJobQueuedResponse, E as VerifyJobStatus, H as VerifyJobStatusResponse, J as VerifySharedProofResponse, K as VerifyUploadedProofRequest, M as VerifyUploadedProofResponse, o as ZkTlsAttestation, m as ZkTlsExtractor, p as ZkTlsSession, Z as ZkTlsSessionStatus, n as ZkTlsWitness } from '../types-Cz9q5U3r.cjs';
+export { B as BindClient, d as deriveCircuitId } from '../client-CfYXpFLk.cjs';
+export { A as ActivateCircuitResult, B as BindClientOptions, j as BindCredential, i as Circuit, C as CircuitStatus, h as CircuitValidationStatus, G as GetVerificationHistoryOptions, L as ListProveJobsOptions, q as ListSharedProofsOptions, P as Pagination, a as PollOptions, e as ProofDownloadUrls, f as ProveJob, c as ProveJobInputs, d as ProveJobOutputs, b as ProveJobStatus, g as ProveJobSummary, R as RevokeSharedProofResult, p as ShareProofRequest, o as SharedProof, S as SubmitProveJobResult, t as VerificationHistoryEntry, V as VerificationMode, s as VerificationResult, r as VerifyJobStatus, m as ZkTlsAttestation, k as ZkTlsExtractor, n as ZkTlsSession, Z as ZkTlsSessionStatus, l as ZkTlsWitness } from '../types-BcPssdQk.cjs';
 export { DisclosureSpec, OutputClaimSpec, PolicyId, PolicyMetadata, PublicPolicySpec, SubjectSpec, ValiditySpec } from '@bind-protocol/policy-spec';
 
 /**

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-export { B as BindClient, d as deriveCircuitId } from '../client-CadOSqx6.js';
-export { A as ActivateCircuitResponse, B as BindClientOptions, l as BindCredential, i as Circuit, C as CircuitStatus, h as CircuitValidationStatus, t as CreateSessionResponse, s as GetAttestationResponse, k as GetCircuitResponse, G as GetProveJobResponse, u as GetSessionResponse, D as GetSharedProofResponse, O as GetVerificationHistoryOptions, Q as GetVerificationHistoryResponse, r as ListAttestationsResponse, j as ListCircuitsResponse, q as ListExtractorsResponse, L as ListProveJobsOptions, g as ListProveJobsResponse, y as ListSharedProofsOptions, z as ListSharedProofsResponse, c as ProofDownloadUrls, d as ProveJob, a as ProveJobInputs, b as ProveJobOutputs, P as ProveJobStatus, e as ProveJobSummary, R as RevokeSharedProofResponse, w as ShareProofRequest, x as ShareProofResponse, v as SharedProof, S as SubmitProveJobRequest, f as SubmitProveJobResponse, N as VerificationHistoryEntry, V as VerificationMode, I as VerificationResult, F as VerifyJobQueuedResponse, E as VerifyJobStatus, H as VerifyJobStatusResponse, J as VerifySharedProofResponse, K as VerifyUploadedProofRequest, M as VerifyUploadedProofResponse, o as ZkTlsAttestation, m as ZkTlsExtractor, p as ZkTlsSession, Z as ZkTlsSessionStatus, n as ZkTlsWitness } from '../types-Cz9q5U3r.js';
+export { B as BindClient, d as deriveCircuitId } from '../client-CpJ87Xe0.js';
+export { A as ActivateCircuitResult, B as BindClientOptions, j as BindCredential, i as Circuit, C as CircuitStatus, h as CircuitValidationStatus, G as GetVerificationHistoryOptions, L as ListProveJobsOptions, q as ListSharedProofsOptions, P as Pagination, a as PollOptions, e as ProofDownloadUrls, f as ProveJob, c as ProveJobInputs, d as ProveJobOutputs, b as ProveJobStatus, g as ProveJobSummary, R as RevokeSharedProofResult, p as ShareProofRequest, o as SharedProof, S as SubmitProveJobResult, t as VerificationHistoryEntry, V as VerificationMode, s as VerificationResult, r as VerifyJobStatus, m as ZkTlsAttestation, k as ZkTlsExtractor, n as ZkTlsSession, Z as ZkTlsSessionStatus, l as ZkTlsWitness } from '../types-BcPssdQk.js';
 export { DisclosureSpec, OutputClaimSpec, PolicyId, PolicyMetadata, PublicPolicySpec, SubjectSpec, ValiditySpec } from '@bind-protocol/policy-spec';
 
 /**

package/dist/core/index.js

@@ -96,33 +96,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();
@@ -131,8 +140,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
@@ -140,21 +148,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);
       }
@@ -174,41 +175,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
@@ -216,49 +204,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
@@ -268,21 +256,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);
       }
@@ -309,6 +290,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();
@@ -316,28 +298,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
@@ -346,18 +327,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();
@@ -368,28 +350,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
@@ -403,83 +384,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) {
+      if (statusResult.status === "completed" || statusResult.status === "failed") {
         return {
-          success: false,
-          error: statusResult.error ?? "Failed to get verification status"
+          isValid: statusResult.isValid ?? false,
+          error: statusResult.error,
+          verificationTimeMs: statusResult.verificationTimeMs ?? 0,
+          creditsCharged: statusResult.creditsCharged ?? queueResult.creditsCharged,
+          verificationResultId: statusResult.verificationResultId ?? jobId,
+          publicInputs: statusResult.publicInputs
         };
       }
-      const status = statusResult.data?.status;
-      if (status === "completed" || 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
-          }
-        };
-      }
-      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();
@@ -487,8 +455,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
@@ -504,8 +471,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));
   }