@proveanything/smartlinks 1.0.6 → 1.0.8

package/src/api/asset.ts

@@ -1,4 +1,4 @@
-import { request } from "../http"
+import { request, post, getApiHeaders } from "../http"
 import { AssetResponse } from "../types/asset"
 
 export namespace asset {
@@ -39,22 +39,95 @@ export namespace asset {
   // Proof-level
   export async function getForProof(
     collectionId: string,
+    productId: string,
     proofId: string,
     assetId: string
   ): Promise<AssetResponse> {
-    const path = `/public/collection/${encodeURIComponent(collectionId)}/proof/${encodeURIComponent(proofId)}/asset/${encodeURIComponent(assetId)}`
+    const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/asset/${encodeURIComponent(assetId)}`
     return request<AssetResponse>(path)
   }
 
   export async function getAllForProof(
     collectionId: string,
+    productId: string,
     proofId: string,
     appId?: string
   ): Promise<AssetResponse[]> {
-    let path = `/public/collection/${encodeURIComponent(collectionId)}/proof/${encodeURIComponent(proofId)}/asset`
+    let path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/asset`
     if (appId) {
       path += `?appId=${encodeURIComponent(appId)}`
     }
     return request<AssetResponse[]>(path)
   }
+
+  /**
+   * Uploads an asset file to a proof, with optional extraData as JSON.
+   * Supports progress reporting via onProgress callback (browser only).
+   * @param collectionId - The collection ID
+   * @param productId - The product ID
+   * @param proofId - The proof ID
+   * @param file - The file to upload
+   * @param extraData - Arbitrary extra data to include (will be stringified as JSON)
+   * @param onProgress - Optional callback for upload progress (0-100)
+   * @returns Promise resolving to an AssetResponse object
+   */
+  export async function uploadAsset(
+    collectionId: string,
+    productId: string,
+    proofId: string,
+    file: File,
+    extraData?: Record<string, any>,
+    onProgress?: (percent: number) => void
+  ): Promise<AssetResponse> {
+    const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/asset`
+    const url = (typeof window !== "undefined" && (window as any).SMARTLINKS_API_BASEURL)
+      ? (window as any).SMARTLINKS_API_BASEURL + path
+      : path // fallback for SSR or Node
+
+    const formData = new FormData()
+    formData.append("file", file)
+    if (extraData) {
+      formData.append("extraData", JSON.stringify(extraData))
+    }
+
+    // Use getApiHeaders from http module
+    const headers = getApiHeaders ? getApiHeaders() : {}
+
+    return new Promise<AssetResponse>((resolve, reject) => {
+      const xhr = new XMLHttpRequest()
+      xhr.open("POST", url)
+
+      // Set headers for API key and bearer token if available
+      for (const [key, value] of Object.entries(headers)) {
+        xhr.setRequestHeader(key, value)
+      }
+
+      xhr.upload.onprogress = (event) => {
+        if (onProgress && event.lengthComputable) {
+          const percent = Math.round((event.loaded / event.total) * 100)
+          onProgress(percent)
+        }
+      }
+
+      xhr.onload = () => {
+        if (xhr.status >= 200 && xhr.status < 300) {
+          try {
+            resolve(JSON.parse(xhr.responseText) as AssetResponse)
+          } catch (e) {
+            reject(new Error("Failed to parse server response"))
+          }
+        } else {
+          try {
+            const errBody = JSON.parse(xhr.responseText)
+            reject(new Error(`Error ${errBody.code}: ${errBody.message}`))
+          } catch {
+            reject(new Error(`Asset upload failed with status ${xhr.status}`))
+          }
+        }
+      }
+
+      xhr.onerror = () => reject(new Error("Network error during asset upload"))
+      xhr.send(formData)
+    })
+  }
 }

package/src/api/attestation.ts

@@ -0,0 +1,69 @@
+import { request, post, put, del } from "../http"
+import type { AttestationResponse, AttestationCreateRequest, AttestationUpdateRequest } from "../types/attestation"
+
+export namespace attestation {
+  /**
+   * Get all attestations for a proof.
+   */
+  export async function getAll(
+    collectionId: string,
+    productId: string,
+    proofId: string
+  ): Promise<AttestationResponse[]> {
+    const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/attestation`
+    return request<AttestationResponse[]>(path)
+  }
+
+  /**
+   * Get a single attestation by ID.
+   */
+  export async function get(
+    collectionId: string,
+    productId: string,
+    proofId: string,
+    attestationId: string
+  ): Promise<AttestationResponse> {
+    const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/attestation/${encodeURIComponent(attestationId)}`
+    return request<AttestationResponse>(path)
+  }
+
+  /**
+   * Create a new attestation for a proof.
+   */
+  export async function create(
+    collectionId: string,
+    productId: string,
+    proofId: string,
+    data: AttestationCreateRequest
+  ): Promise<AttestationResponse> {
+    const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/attestation`
+    return post<AttestationResponse>(path, data)
+  }
+
+  /**
+   * Update an attestation.
+   */
+  export async function update(
+    collectionId: string,
+    productId: string,
+    proofId: string,
+    attestationId: string,
+    data: AttestationUpdateRequest
+  ): Promise<AttestationResponse> {
+    const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/attestation/${encodeURIComponent(attestationId)}`
+    return put<AttestationResponse>(path, data)
+  }
+
+  /**
+   * Delete an attestation.
+   */
+  export async function remove(
+    collectionId: string,
+    productId: string,
+    proofId: string,
+    attestationId: string
+  ): Promise<void> {
+    const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}/attestation/${encodeURIComponent(attestationId)}`
+    return del<void>(path)
+  }
+}

package/src/api/index.ts

@@ -5,3 +5,4 @@ export { product } from "./product"
 export { proof } from "./proof"
 export { appConfiguration } from "./appConfiguration"
 export { asset } from "./asset"
+export { attestation } from "./attestation"

package/src/http.ts

@@ -62,3 +62,193 @@ export async function request<T>(path: string): Promise<T> {
 
   return (await response.json()) as T
 }
+
+/**
+ * Internal helper that performs a POST request to `${baseURL}${path}`,
+ * injecting headers for apiKey or bearerToken if present.
+ * If body is FormData, Content-Type is not set.
+ * Returns the parsed JSON as T, or throws an Error.
+ */
+export async function post<T>(
+  path: string,
+  body: any,
+  extraHeaders?: Record<string, string>
+): Promise<T> {
+  if (!baseURL) {
+    throw new Error("HTTP client is not initialized. Call initializeApi(...) first.")
+  }
+
+  const url = `${baseURL}${path}`
+  const headers: Record<string, string> = extraHeaders ? { ...extraHeaders } : {}
+
+  if (apiKey) headers["X-API-Key"] = apiKey
+  if (bearerToken) headers["AUTHORIZATION"] = `Bearer ${bearerToken}`
+
+  // Only set Content-Type for non-FormData bodies
+  if (!(body instanceof FormData)) {
+    headers["Content-Type"] = "application/json"
+  }
+
+  const response = await fetch(url, {
+    method: "POST",
+    headers,
+    body: body instanceof FormData ? body : JSON.stringify(body),
+  })
+
+  if (!response.ok) {
+    try {
+      const errBody = (await response.json()) as import("./types/error").ErrorResponse
+      throw new Error(`Error ${errBody.code}: ${errBody.message}`)
+    } catch {
+      throw new Error(`Request to ${url} failed with status ${response.status}`)
+    }
+  }
+
+  return (await response.json()) as T
+}
+
+/**
+ * Internal helper that performs a PUT request to `${baseURL}${path}`,
+ * injecting headers for apiKey or bearerToken if present.
+ * If body is FormData, Content-Type is not set.
+ * Returns the parsed JSON as T, or throws an Error.
+ */
+export async function put<T>(
+  path: string,
+  body: any,
+  extraHeaders?: Record<string, string>
+): Promise<T> {
+  if (!baseURL) {
+    throw new Error("HTTP client is not initialized. Call initializeApi(...) first.")
+  }
+
+  const url = `${baseURL}${path}`
+  const headers: Record<string, string> = extraHeaders ? { ...extraHeaders } : {}
+
+  if (apiKey) headers["X-API-Key"] = apiKey
+  if (bearerToken) headers["AUTHORIZATION"] = `Bearer ${bearerToken}`
+
+  // Only set Content-Type for non-FormData bodies
+  if (!(body instanceof FormData)) {
+    headers["Content-Type"] = "application/json"
+  }
+
+  const response = await fetch(url, {
+    method: "PUT",
+    headers,
+    body: body instanceof FormData ? body : JSON.stringify(body),
+  })
+
+  if (!response.ok) {
+    try {
+      const errBody = (await response.json()) as import("./types/error").ErrorResponse
+      throw new Error(`Error ${errBody.code}: ${errBody.message}`)
+    } catch {
+      throw new Error(`Request to ${url} failed with status ${response.status}`)
+    }
+  }
+
+  return (await response.json()) as T
+}
+
+/**
+ * Internal helper that performs a request to `${baseURL}${path}` with custom options,
+ * injecting headers for apiKey or bearerToken if present.
+ * Returns the parsed JSON as T, or throws an Error.
+ */
+export async function requestWithOptions<T>(
+  path: string,
+  options: RequestInit
+): Promise<T> {
+  if (!baseURL) {
+    throw new Error("HTTP client is not initialized. Call initializeApi(...) first.")
+  }
+  const url = `${baseURL}${path}`
+
+  // Safely merge headers, converting Headers/init to Record<string, string>
+  let extraHeaders: Record<string, string> = {}
+  if (options.headers) {
+    if (options.headers instanceof Headers) {
+      options.headers.forEach((value, key) => {
+        extraHeaders[key] = value
+      })
+    } else if (Array.isArray(options.headers)) {
+      for (const [key, value] of options.headers) {
+        extraHeaders[key] = value
+      }
+    } else {
+      extraHeaders = { ...(options.headers as Record<string, string>) }
+    }
+  }
+
+  const headers: Record<string, string> = {
+    "Content-Type": "application/json",
+    ...(apiKey ? { "X-API-Key": apiKey } : {}),
+    ...(bearerToken ? { "AUTHORIZATION": `Bearer ${bearerToken}` } : {}),
+    ...extraHeaders,
+  }
+
+  const response = await fetch(url, {
+    ...options,
+    headers,
+  })
+
+  if (!response.ok) {
+    try {
+      const errBody = (await response.json()) as import("./types/error").ErrorResponse
+      throw new Error(`Error ${errBody.code}: ${errBody.message}`)
+    } catch {
+      throw new Error(`Request to ${url} failed with status ${response.status}`)
+    }
+  }
+
+  return (await response.json()) as T
+}
+
+/**
+ * Internal helper that performs a DELETE request to `${baseURL}${path}`,
+ * injecting headers for apiKey or bearerToken if present.
+ * Returns the parsed JSON as T, or throws an Error.
+ */
+export async function del<T>(
+  path: string,
+  extraHeaders?: Record<string, string>
+): Promise<T> {
+  if (!baseURL) {
+    throw new Error("HTTP client is not initialized. Call initializeApi(...) first.")
+  }
+
+  const url = `${baseURL}${path}`
+  const headers: Record<string, string> = extraHeaders ? { ...extraHeaders } : {}
+
+  if (apiKey) headers["X-API-Key"] = apiKey
+  if (bearerToken) headers["AUTHORIZATION"] = `Bearer ${bearerToken}`
+
+  const response = await fetch(url, {
+    method: "DELETE",
+    headers,
+  })
+
+  if (!response.ok) {
+    try {
+      const errBody = (await response.json()) as import("./types/error").ErrorResponse
+      throw new Error(`Error ${errBody.code}: ${errBody.message}`)
+    } catch {
+      throw new Error(`Request to ${url} failed with status ${response.status}`)
+    }
+  }
+
+  // If the response is empty, just return undefined
+  if (response.status === 204) return undefined as T
+  return (await response.json()) as T
+}
+
+/**
+ * Returns the common headers used for API requests, including apiKey and bearerToken if set.
+ */
+export function getApiHeaders(): Record<string, string> {
+  const headers: Record<string, string> = {}
+  if (apiKey) headers["X-API-Key"] = apiKey
+  if (bearerToken) headers["AUTHORIZATION"] = `Bearer ${bearerToken}`
+  return headers
+}

package/src/types/attestation.ts

@@ -0,0 +1,18 @@
+export interface AttestationResponse {
+  id: string
+  proofId: string
+  createdAt: string
+  updatedAt: string
+  type: string
+  data: Record<string, any>
+}
+
+export interface AttestationCreateRequest {
+  type: string
+  data: Record<string, any>
+}
+
+export interface AttestationUpdateRequest {
+  type?: string
+  data?: Record<string, any>
+}