pinata 1.9.1 → 1.10.1

package/dist/index.d.mts

@@ -44,6 +44,7 @@ type UploadOptions = {
     keys?: string;
     groupId?: string;
     vectorize?: boolean;
+    url?: string;
 };
 type DeleteResponse = {
     id: string;
@@ -316,6 +317,14 @@ type VectorizeQueryResponse = {
     count: number;
     matches: VectorQueryMatch[];
 };
+type SignedUploadUrlOptions = {
+    date?: number;
+    expires: number;
+    groupId?: string;
+    name?: string;
+    keyvalues?: Record<string, string>;
+    vectorize?: boolean;
+};
 
 declare class PinataSDK {
     config: PinataConfig | undefined;
@@ -352,10 +361,12 @@ declare class UploadBuilder<T> {
     private keys;
     private groupId;
     private vector;
+    private uploadUrl;
     constructor(config: PinataConfig | undefined, uploadFunction: (config: PinataConfig | undefined, ...args: any[]) => Promise<T>, ...args: any[]);
     addMetadata(metadata: PinataMetadata): UploadBuilder<T>;
     key(jwt: string): UploadBuilder<T>;
     vectorize(): UploadBuilder<T>;
+    url(url: string): UploadBuilder<T>;
     group(groupId: string): UploadBuilder<T>;
     then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
 }
@@ -367,6 +378,7 @@ declare class Upload {
     base64(base64String: string, options?: UploadOptions): UploadBuilder<UploadResponse>;
     url(url: string, options?: UploadOptions): UploadBuilder<UploadResponse>;
     json(data: object, options?: UploadOptions): UploadBuilder<UploadResponse>;
+    createSignedURL(options: SignedUploadUrlOptions): Promise<string>;
 }
 declare class FilterFiles {
     private config;
@@ -524,4 +536,4 @@ declare class TimeIntervalAnalyticsBuilder extends AnalyticsBuilder<TimeInterval
     all(): Promise<TimeIntervalAnalyticsResponse>;
 }
 
-export { type AnalyticsQuery, type AuthTestResponse, type ContainsCIDResponse, type ContentType, type DataEndponts, type DeleteResponse, type Endpoints, type FileListItem, type FileListQuery, type FileListResponse, type FileObject, type GetCIDResponse, type GetGroupOptions, type GroupCIDOptions, type GroupListResponse, type GroupOptions, type GroupQueryOptions, type GroupResponseItem, type JsonBody, type KeyListItem, type KeyListQuery, type KeyListResponse, type KeyOptions, type KeyPermissions, type KeyResponse, type OptimizeImageOptions, type PinJobItem, type PinJobQuery, type PinJobResponse, type PinataConfig, type PinataMetadata, PinataSDK, type PinningEndpoints, type RevokeKeyResponse, type SignatureOptions, type SignatureResponse, type SignedUrlOptions, type SwapCidOptions, type SwapCidResponse, type SwapHistoryOptions, type TimeIntervalAnalyticsQuery, type TimeIntervalAnalyticsResponse, type TimePeriodItem, type TopAnalyticsItem, type TopAnalyticsQuery, type TopAnalyticsResponse, type UpdateFileOptions, type UpdateGroupFilesResponse, type UpdateGroupOptions, type UploadOptions, type UploadResponse, type UserPinnedDataResponse, type VectorQueryMatch, type VectorizeFileResponse, type VectorizeQuery, type VectorizeQueryResponse };
+export { type AnalyticsQuery, type AuthTestResponse, type ContainsCIDResponse, type ContentType, type DataEndponts, type DeleteResponse, type Endpoints, type FileListItem, type FileListQuery, type FileListResponse, type FileObject, type GetCIDResponse, type GetGroupOptions, type GroupCIDOptions, type GroupListResponse, type GroupOptions, type GroupQueryOptions, type GroupResponseItem, type JsonBody, type KeyListItem, type KeyListQuery, type KeyListResponse, type KeyOptions, type KeyPermissions, type KeyResponse, type OptimizeImageOptions, type PinJobItem, type PinJobQuery, type PinJobResponse, type PinataConfig, type PinataMetadata, PinataSDK, type PinningEndpoints, type RevokeKeyResponse, type SignatureOptions, type SignatureResponse, type SignedUploadUrlOptions, type SignedUrlOptions, type SwapCidOptions, type SwapCidResponse, type SwapHistoryOptions, type TimeIntervalAnalyticsQuery, type TimeIntervalAnalyticsResponse, type TimePeriodItem, type TopAnalyticsItem, type TopAnalyticsQuery, type TopAnalyticsResponse, type UpdateFileOptions, type UpdateGroupFilesResponse, type UpdateGroupOptions, type UploadOptions, type UploadResponse, type UserPinnedDataResponse, type VectorQueryMatch, type VectorizeFileResponse, type VectorizeQuery, type VectorizeQueryResponse };

package/dist/index.d.ts

@@ -44,6 +44,7 @@ type UploadOptions = {
     keys?: string;
     groupId?: string;
     vectorize?: boolean;
+    url?: string;
 };
 type DeleteResponse = {
     id: string;
@@ -316,6 +317,14 @@ type VectorizeQueryResponse = {
     count: number;
     matches: VectorQueryMatch[];
 };
+type SignedUploadUrlOptions = {
+    date?: number;
+    expires: number;
+    groupId?: string;
+    name?: string;
+    keyvalues?: Record<string, string>;
+    vectorize?: boolean;
+};
 
 declare class PinataSDK {
     config: PinataConfig | undefined;
@@ -352,10 +361,12 @@ declare class UploadBuilder<T> {
     private keys;
     private groupId;
     private vector;
+    private uploadUrl;
     constructor(config: PinataConfig | undefined, uploadFunction: (config: PinataConfig | undefined, ...args: any[]) => Promise<T>, ...args: any[]);
     addMetadata(metadata: PinataMetadata): UploadBuilder<T>;
     key(jwt: string): UploadBuilder<T>;
     vectorize(): UploadBuilder<T>;
+    url(url: string): UploadBuilder<T>;
     group(groupId: string): UploadBuilder<T>;
     then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
 }
@@ -367,6 +378,7 @@ declare class Upload {
     base64(base64String: string, options?: UploadOptions): UploadBuilder<UploadResponse>;
     url(url: string, options?: UploadOptions): UploadBuilder<UploadResponse>;
     json(data: object, options?: UploadOptions): UploadBuilder<UploadResponse>;
+    createSignedURL(options: SignedUploadUrlOptions): Promise<string>;
 }
 declare class FilterFiles {
     private config;
@@ -524,4 +536,4 @@ declare class TimeIntervalAnalyticsBuilder extends AnalyticsBuilder<TimeInterval
     all(): Promise<TimeIntervalAnalyticsResponse>;
 }
 
-export { type AnalyticsQuery, type AuthTestResponse, type ContainsCIDResponse, type ContentType, type DataEndponts, type DeleteResponse, type Endpoints, type FileListItem, type FileListQuery, type FileListResponse, type FileObject, type GetCIDResponse, type GetGroupOptions, type GroupCIDOptions, type GroupListResponse, type GroupOptions, type GroupQueryOptions, type GroupResponseItem, type JsonBody, type KeyListItem, type KeyListQuery, type KeyListResponse, type KeyOptions, type KeyPermissions, type KeyResponse, type OptimizeImageOptions, type PinJobItem, type PinJobQuery, type PinJobResponse, type PinataConfig, type PinataMetadata, PinataSDK, type PinningEndpoints, type RevokeKeyResponse, type SignatureOptions, type SignatureResponse, type SignedUrlOptions, type SwapCidOptions, type SwapCidResponse, type SwapHistoryOptions, type TimeIntervalAnalyticsQuery, type TimeIntervalAnalyticsResponse, type TimePeriodItem, type TopAnalyticsItem, type TopAnalyticsQuery, type TopAnalyticsResponse, type UpdateFileOptions, type UpdateGroupFilesResponse, type UpdateGroupOptions, type UploadOptions, type UploadResponse, type UserPinnedDataResponse, type VectorQueryMatch, type VectorizeFileResponse, type VectorizeQuery, type VectorizeQueryResponse };
+export { type AnalyticsQuery, type AuthTestResponse, type ContainsCIDResponse, type ContentType, type DataEndponts, type DeleteResponse, type Endpoints, type FileListItem, type FileListQuery, type FileListResponse, type FileObject, type GetCIDResponse, type GetGroupOptions, type GroupCIDOptions, type GroupListResponse, type GroupOptions, type GroupQueryOptions, type GroupResponseItem, type JsonBody, type KeyListItem, type KeyListQuery, type KeyListResponse, type KeyOptions, type KeyPermissions, type KeyResponse, type OptimizeImageOptions, type PinJobItem, type PinJobQuery, type PinJobResponse, type PinataConfig, type PinataMetadata, PinataSDK, type PinningEndpoints, type RevokeKeyResponse, type SignatureOptions, type SignatureResponse, type SignedUploadUrlOptions, type SignedUrlOptions, type SwapCidOptions, type SwapCidResponse, type SwapHistoryOptions, type TimeIntervalAnalyticsQuery, type TimeIntervalAnalyticsResponse, type TimePeriodItem, type TopAnalyticsItem, type TopAnalyticsQuery, type TopAnalyticsResponse, type UpdateFileOptions, type UpdateGroupFilesResponse, type UpdateGroupOptions, type UploadOptions, type UploadResponse, type UserPinnedDataResponse, type VectorQueryMatch, type VectorizeFileResponse, type VectorizeQuery, type VectorizeQueryResponse };

package/dist/index.js

@@ -150,7 +150,11 @@ var uploadFile = async (config, file, options) => {
     if (options?.metadata?.keyvalues) {
       metadata + `,keyvalues ${btoa(JSON.stringify(options.metadata.keyvalues))}`;
     }
-    const urlReq = await fetch(`${endpoint}/files`, {
+    let updatedEndpoint = `${endpoint}/files`;
+    if (options?.url) {
+      updatedEndpoint = options.url;
+    }
+    const urlReq = await fetch(updatedEndpoint, {
       method: "POST",
       headers: {
         "Upload-Length": `${file.size}`,
@@ -242,6 +246,43 @@ var uploadFile = async (config, file, options) => {
   }
   const data = new FormData();
   data.append("file", file, file.name);
+  if (options?.url) {
+    try {
+      const request = await fetch(options.url, {
+        method: "POST",
+        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
+          );
+        }
+        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 base64: ${error.message}`);
+      }
+      throw new PinataError(
+        "An unknown error occurred while trying to upload base64"
+      );
+    }
+  }
   data.append("name", options?.metadata?.name || file.name || "File from SDK");
   if (options?.groupId) {
     data.append("group_id", options.groupId);
@@ -340,6 +381,42 @@ var uploadBase64 = async (config, base64String, options) => {
   if (config.uploadUrl) {
     endpoint = config.uploadUrl;
   }
+  if (options?.url) {
+    try {
+      const request = await fetch(options.url, {
+        method: "POST",
+        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
+          );
+        }
+        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 base64: ${error.message}`);
+      }
+      throw new PinataError(
+        "An unknown error occurred while trying to upload base64"
+      );
+    }
+  }
   try {
     const request = await fetch(`${endpoint}/files`, {
       method: "POST",
@@ -443,6 +520,42 @@ var uploadUrl = async (config, url, options) => {
   if (config.uploadUrl) {
     endpoint = config.uploadUrl;
   }
+  if (options?.url) {
+    try {
+      const request = await fetch(options.url, {
+        method: "POST",
+        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
+          );
+        }
+        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 base64: ${error.message}`);
+      }
+      throw new PinataError(
+        "An unknown error occurred while trying to upload base64"
+      );
+    }
+  }
   try {
     const request = await fetch(`${endpoint}/files`, {
       method: "POST",
@@ -534,6 +647,42 @@ var uploadJson = async (config, jsonData, options) => {
   if (config.uploadUrl) {
     endpoint = config.uploadUrl;
   }
+  if (options?.url) {
+    try {
+      const request = await fetch(options.url, {
+        method: "POST",
+        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
+          );
+        }
+        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 base64: ${error.message}`);
+      }
+      throw new PinataError(
+        "An unknown error occurred while trying to upload base64"
+      );
+    }
+  }
   try {
     const request = await fetch(`${endpoint}/files`, {
       method: "POST",
@@ -2310,6 +2459,79 @@ var deleteFileVectors = async (config, fileId) => {
   }
 };
 
+// src/core/uploads/createSignedUploadURL.ts
+var createSignedUploadURL = async (config, options) => {
+  if (!config) {
+    throw new ValidationError("Pinata configuration is missing");
+  }
+  const date = options?.date || Math.floor((/* @__PURE__ */ new Date()).getTime() / 1e3);
+  const payload = {
+    date,
+    expires: options.expires
+  };
+  if (options.groupId) {
+    payload.group_id = options.groupId;
+  }
+  if (options.name) {
+    payload.filename = options.name;
+  }
+  if (options.keyvalues) {
+    payload.keyvalues = options.keyvalues;
+  }
+  let endpoint = "https://uploads.pinata.cloud/v3";
+  if (config.uploadUrl) {
+    endpoint = config.uploadUrl;
+  }
+  let headers;
+  if (config.customHeaders && Object.keys(config.customHeaders).length > 0) {
+    headers = {
+      Authorization: `Bearer ${config.pinataJwt}`,
+      "Content-Type": "application/json",
+      ...config.customHeaders
+    };
+  } else {
+    headers = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config.pinataJwt}`,
+      Source: "sdk/createSignURL"
+    };
+  }
+  try {
+    const request = await fetch(`${endpoint}/files/sign`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(payload)
+    });
+    if (!request.ok) {
+      const errorData = await request.text();
+      if (request.status === 401 || request.status === 403) {
+        throw new AuthenticationError(
+          `Authentication Failed: ${errorData}`,
+          request.status,
+          errorData
+        );
+      }
+      throw new NetworkError(
+        `HTTP error: ${errorData}`,
+        request.status,
+        errorData
+      );
+    }
+    const res = await request.json();
+    return res.data;
+  } catch (error) {
+    if (error instanceof PinataError) {
+      throw error;
+    }
+    if (error instanceof Error) {
+      throw new PinataError(
+        `Error processing createSignedURL: ${error.message}`
+      );
+    }
+    throw new PinataError("An unknown error occurred while getting signed url");
+  }
+};
+
 // src/core/pinataSDK.ts
 var formatConfig = (config) => {
   let gateway = config?.pinataGateway;
@@ -2413,6 +2635,10 @@ var UploadBuilder = class {
     this.vector = true;
     return this;
   }
+  url(url) {
+    this.uploadUrl = url;
+    return this;
+  }
   // cidVersion(v: 0 | 1): UploadBuilder<T> {
   // 	this.version = v;
   // 	return this;
@@ -2435,6 +2661,9 @@ var UploadBuilder = class {
     if (this.vector) {
       options.vectorize = this.vector;
     }
+    if (this.uploadUrl) {
+      options.url = this.uploadUrl;
+    }
     this.args[this.args.length - 1] = options;
     return this.uploadFunction(this.config, ...this.args).then(
       onfulfilled,
@@ -2467,6 +2696,9 @@ var Upload = class {
   json(data, options) {
     return new UploadBuilder(this.config, uploadJson, data, options);
   }
+  createSignedURL(options) {
+    return createSignedUploadURL(this.config, options);
+  }
 };
 var FilterFiles = class {
   // rate limit vars