pinata 1.2.0 → 1.4.0

package/dist/index.d.mts

@@ -116,6 +116,7 @@ type SignedUrlOptions = {
     cid: string;
     date?: number;
     expires: number;
+    gateway?: string;
 };
 type GatewayAnalyticsQuery = {
     gateway_domain: string;
@@ -276,8 +277,8 @@ type SwapHistoryOptions = {
     domain: string;
 };
 type SwapCidResponse = {
-    mappedCid: string;
-    createdAt: string;
+    mapped_cid: string;
+    created_at: string;
 };
 type ContainsCIDResponse = {
     containsCid: boolean;
@@ -302,6 +303,9 @@ declare class Files {
     list(): FilterFiles;
     delete(files: string[]): Promise<DeleteResponse[]>;
     update(options: UpdateFileOptions): Promise<FileListItem>;
+    addSwap(options: SwapCidOptions): Promise<SwapCidResponse>;
+    getSwapHistory(options: SwapHistoryOptions): Promise<SwapCidResponse[]>;
+    deleteSwap(cid: string): Promise<string>;
 }
 declare class UploadBuilder<T> {
     private config;

package/dist/index.d.ts

@@ -116,6 +116,7 @@ type SignedUrlOptions = {
     cid: string;
     date?: number;
     expires: number;
+    gateway?: string;
 };
 type GatewayAnalyticsQuery = {
     gateway_domain: string;
@@ -276,8 +277,8 @@ type SwapHistoryOptions = {
     domain: string;
 };
 type SwapCidResponse = {
-    mappedCid: string;
-    createdAt: string;
+    mapped_cid: string;
+    created_at: string;
 };
 type ContainsCIDResponse = {
     containsCid: boolean;
@@ -302,6 +303,9 @@ declare class Files {
     list(): FilterFiles;
     delete(files: string[]): Promise<DeleteResponse[]>;
     update(options: UpdateFileOptions): Promise<FileListItem>;
+    addSwap(options: SwapCidOptions): Promise<SwapCidResponse>;
+    getSwapHistory(options: SwapHistoryOptions): Promise<SwapCidResponse[]>;
+    deleteSwap(cid: string): Promise<string>;
 }
 declare class UploadBuilder<T> {
     private config;

package/dist/index.js

@@ -1149,12 +1149,219 @@ var deleteGroup = async (config, options) => {
   }
 };
 
+// src/core/files/swapCid.ts
+var swapCid = async (config, options) => {
+  if (!config) {
+    throw new ValidationError("Pinata configuration is missing");
+  }
+  const data = JSON.stringify({
+    swap_cid: options.swapCid
+  });
+  let headers;
+  if (config.customHeaders && Object.keys(config.customHeaders).length > 0) {
+    headers = { ...config.customHeaders };
+  } else {
+    headers = {
+      Authorization: `Bearer ${config.pinataJwt}`,
+      "Content-Type": "application/json",
+      Source: "sdk/swapCid"
+    };
+  }
+  let endpoint = "https://api.pinata.cloud/v3";
+  if (config.endpointUrl) {
+    endpoint = config.endpointUrl;
+  }
+  try {
+    const request = await fetch(`${endpoint}/files/swap/${options.cid}`, {
+      method: "PUT",
+      headers,
+      body: data
+    });
+    if (!request.ok) {
+      const errorData = await request.text();
+      if (request.status === 401 || request.status === 403) {
+        throw new AuthenticationError(
+          `Authentication failed: ${errorData}`,
+          request.status,
+          errorData
+        );
+      }
+      if (request.status === 403) {
+        throw new PinataError(
+          "Unauthorized CID Swap",
+          request.status,
+          errorData
+        );
+      }
+      if (request.status === 404) {
+        throw new PinataError(
+          "CID not pinned to account",
+          request.status,
+          errorData
+        );
+      }
+      throw new NetworkError(
+        `HTTP error: ${errorData}`,
+        request.status,
+        errorData
+      );
+    }
+    const res = await request.json();
+    const resData = res.data;
+    return resData;
+  } catch (error) {
+    if (error instanceof PinataError) {
+      throw error;
+    }
+    if (error instanceof Error) {
+      throw new PinataError(`Error processing CID Swap: ${error.message}`);
+    }
+    throw new PinataError("An unknown error occurred while swapping CID");
+  }
+};
+
+// src/core/files/swapHistory.ts
+var swapHistory = async (config, options) => {
+  if (!config) {
+    throw new ValidationError("Pinata configuration is missing");
+  }
+  let headers;
+  if (config.customHeaders && Object.keys(config.customHeaders).length > 0) {
+    headers = { ...config.customHeaders };
+  } else {
+    headers = {
+      Authorization: `Bearer ${config.pinataJwt}`,
+      "Content-Type": "application/json",
+      Source: "sdk/swapHistory"
+    };
+  }
+  let endpoint = "https://api.pinata.cloud/v3";
+  if (config.endpointUrl) {
+    endpoint = config.endpointUrl;
+  }
+  try {
+    const request = await fetch(
+      `${endpoint}/files/swap/${options.cid}?domain=${options.domain}`,
+      {
+        method: "GET",
+        headers
+      }
+    );
+    if (!request.ok) {
+      const errorData = await request.text();
+      if (request.status === 401 || request.status === 403) {
+        throw new AuthenticationError(
+          `Authentication failed: ${errorData}`,
+          request.status,
+          errorData
+        );
+      }
+      if (request.status === 404) {
+        throw new PinataError(
+          "CID does not have history",
+          request.status,
+          errorData
+        );
+      }
+      throw new NetworkError(
+        `HTTP error: ${errorData}`,
+        request.status,
+        errorData
+      );
+    }
+    const res = await request.json();
+    const resData = res.data;
+    return resData;
+  } catch (error) {
+    if (error instanceof PinataError) {
+      throw error;
+    }
+    if (error instanceof Error) {
+      throw new PinataError(`Error fetching swap history: ${error.message}`);
+    }
+    throw new PinataError(
+      "An unknown error occurred while fetching swap history"
+    );
+  }
+};
+
+// src/core/files/deleteSwap.ts
+var deleteSwap = async (config, cid) => {
+  if (!config) {
+    throw new ValidationError("Pinata configuration is missing");
+  }
+  let headers;
+  if (config.customHeaders && Object.keys(config.customHeaders).length > 0) {
+    headers = { ...config.customHeaders };
+  } else {
+    headers = {
+      Authorization: `Bearer ${config.pinataJwt}`,
+      "Content-Type": "application/json",
+      Source: "sdk/deleteSwap"
+    };
+  }
+  let endpoint = "https://api.pinata.cloud/v3";
+  if (config.endpointUrl) {
+    endpoint = config.endpointUrl;
+  }
+  try {
+    const request = await fetch(`${endpoint}/files/swap/${cid}`, {
+      method: "DELETE",
+      headers
+    });
+    if (!request.ok) {
+      const errorData = await request.text();
+      if (request.status === 401 || request.status === 403) {
+        throw new AuthenticationError(
+          `Authentication failed: ${errorData}`,
+          request.status,
+          errorData
+        );
+      }
+      if (request.status === 403) {
+        throw new PinataError(
+          "Unauthorized CID Swap Deletion",
+          request.status,
+          errorData
+        );
+      }
+      if (request.status === 404) {
+        throw new PinataError(
+          "CID not pinned to account",
+          request.status,
+          errorData
+        );
+      }
+      throw new NetworkError(
+        `HTTP error: ${errorData}`,
+        request.status,
+        errorData
+      );
+    }
+    return request.statusText;
+  } catch (error) {
+    if (error instanceof PinataError) {
+      throw error;
+    }
+    if (error instanceof Error) {
+      throw new PinataError(`Error processing deleteSwap: ${error.message}`);
+    }
+    throw new PinataError("An unknown error occurred while deleting swap");
+  }
+};
+
 // src/core/gateway/createSignedURL.ts
 var createSignedURL = async (config, options, imgOpts) => {
   if (!config) {
     throw new ValidationError("Pinata configuration is missing");
   }
-  let newUrl = `${config?.pinataGateway}/files/${options.cid}`;
+  let baseUrl;
+  if (options?.gateway) {
+    baseUrl = options.gateway.startsWith("https://") ? options.gateway : `https://${options.gateway}`;
+  } else {
+    baseUrl = config.pinataGateway;
+  }
+  let newUrl = `${baseUrl}/files/${options.cid}`;
   const params = new URLSearchParams();
   if (imgOpts) {
     if (imgOpts.width)
@@ -1286,6 +1493,15 @@ var Files = class {
   update(options) {
     return updateFile(this.config, options);
   }
+  addSwap(options) {
+    return swapCid(this.config, options);
+  }
+  getSwapHistory(options) {
+    return swapHistory(this.config, options);
+  }
+  deleteSwap(cid) {
+    return deleteSwap(this.config, cid);
+  }
 };
 var UploadBuilder = class {
   constructor(config, uploadFunction, ...args) {
@@ -1452,15 +1668,6 @@ var Gateways = class {
   createSignedURL(options) {
     return new OptimizeImageCreateSignedURL(this.config, options);
   }
-  // get(cid: string): OptimizeImage {
-  // 	return new OptimizeImage(this.config, cid);
-  // }
-  // convert(url: string, gatewayPrefix?: string): Promise<string> {
-  // 	return convertIPFSUrl(this.config, url, gatewayPrefix);
-  // }
-  // containsCID(cid: string): Promise<ContainsCIDResponse> {
-  // 	return containsCID(cid);
-  // }
   // topUsageAnalytics(options: {
   // 	domain: string;
   // 	start: string;
@@ -1497,15 +1704,6 @@ var Gateways = class {
   // 		options.interval,
   // 	);
   // }
-  // swapCid(options: SwapCidOptions): Promise<SwapCidResponse> {
-  // 	return swapCid(this.config, options);
-  // }
-  // swapHistory(options: SwapHistoryOptions): Promise<SwapCidResponse[]> {
-  // 	return swapHistory(this.config, options);
-  // }
-  // deleteSwap(cid: string): Promise<string> {
-  // 	return deleteSwap(this.config, cid);
-  // }
 };
 var OptimizeImageGetCid = class {
   constructor(config, cid) {