pinata 2.5.4 → 2.5.6

package/README.md

@@ -6,7 +6,7 @@ The new all-in-one Pinata SDK
 
 ## Quickstart
 
-[View the full documentation here](https://docs.pinata.cloud/sdk-beta/getting-started)
+[View the full documentation here](https://docs.pinata.cloud/quickstart)
 
 ### 1. Install
 

package/dist/{gateway-tools-C-tdEyF2.d.mts → gateway-tools-Cx64TJRo.d.mts}

@@ -179,7 +179,28 @@ type SignedUploadUrlOptions = {
     keyvalues?: Record<string, string>;
     vectorize?: boolean;
     maxFileSize?: number;
+    /**
+     * Restrict the signed URL to specific MIME types.
+     *
+     * NOTE: For directory uploads (e.g. `pinata.upload.public.fileArray(...).url(...)`),
+     * this array MUST include the synthetic `"directory"` MIME type — otherwise the
+     * upload will be rejected with `400 "Presigned URL does not grant permissions to
+     * upload detected MIME type: directory"`. Aliases like `application/x-directory` or
+     * `inode/directory` are NOT accepted, and a wildcard (`["*"]` / `["*\/*"]`) does not
+     * cover it.
+     *
+     * Example: `mimeTypes: ["directory"]` (or `["directory", "text/plain"]` to also
+     * allow plain-text files inside the directory).
+     */
     mimeTypes?: string[];
+    /**
+     * Mint this signed URL for directory uploads (e.g. `fileArray(...).url(...)`).
+     *
+     * Adds `"directory"` to `mimeTypes` so the API permits the synthetic directory
+     * MIME type. Any other entries in `mimeTypes` are preserved, so you can both
+     * allow a directory and constrain the file types inside it.
+     */
+    forDirectory?: boolean;
     streamable?: boolean;
     car?: boolean;
     /**

package/dist/{gateway-tools-C-tdEyF2.d.ts → gateway-tools-Cx64TJRo.d.ts}

@@ -179,7 +179,28 @@ type SignedUploadUrlOptions = {
     keyvalues?: Record<string, string>;
     vectorize?: boolean;
     maxFileSize?: number;
+    /**
+     * Restrict the signed URL to specific MIME types.
+     *
+     * NOTE: For directory uploads (e.g. `pinata.upload.public.fileArray(...).url(...)`),
+     * this array MUST include the synthetic `"directory"` MIME type — otherwise the
+     * upload will be rejected with `400 "Presigned URL does not grant permissions to
+     * upload detected MIME type: directory"`. Aliases like `application/x-directory` or
+     * `inode/directory` are NOT accepted, and a wildcard (`["*"]` / `["*\/*"]`) does not
+     * cover it.
+     *
+     * Example: `mimeTypes: ["directory"]` (or `["directory", "text/plain"]` to also
+     * allow plain-text files inside the directory).
+     */
     mimeTypes?: string[];
+    /**
+     * Mint this signed URL for directory uploads (e.g. `fileArray(...).url(...)`).
+     *
+     * Adds `"directory"` to `mimeTypes` so the API permits the synthetic directory
+     * MIME type. Any other entries in `mimeTypes` are preserved, so you can both
+     * allow a directory and constrain the file types inside it.
+     */
+    forDirectory?: boolean;
     streamable?: boolean;
     car?: boolean;
     /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { D as DeleteResponse, V as VectorizeFileResponse, F as FileListQuery, a as FileListResponse, S as SwapCidOptions, b as SwapCidResponse, c as SwapHistoryOptions, U as UpdateFileOptions, d as FileListItem, e as VectorizeQuery, f as VectorizeQueryResponse, G as GetCIDResponse, P as PinQueueQuery, g as PinQueueResponse, O as OptimizeImageOptions, A as AccessLinkOptions, h as UploadOptions, i as UploadResponse, j as SignedUploadUrlOptions, J as JsonBody, k as UploadCIDOptions, l as PinByCIDResponse, m as PinQueueItem, C as CidVersion } from './gateway-tools-C-tdEyF2.mjs';
-export { t as AuthenticationError, r as ContainsCIDResponse, q as ContentType, n as FileObject, N as NetworkError, s as PinataError, o as PinataMetadata, u as ValidationError, p as VectorQueryMatch, v as containsCID, w as convertToDesiredGateway } from './gateway-tools-C-tdEyF2.mjs';
+import { D as DeleteResponse, V as VectorizeFileResponse, F as FileListQuery, a as FileListResponse, S as SwapCidOptions, b as SwapCidResponse, c as SwapHistoryOptions, U as UpdateFileOptions, d as FileListItem, e as VectorizeQuery, f as VectorizeQueryResponse, G as GetCIDResponse, P as PinQueueQuery, g as PinQueueResponse, O as OptimizeImageOptions, A as AccessLinkOptions, h as UploadOptions, i as UploadResponse, j as SignedUploadUrlOptions, J as JsonBody, k as UploadCIDOptions, l as PinByCIDResponse, m as PinQueueItem, C as CidVersion } from './gateway-tools-Cx64TJRo.mjs';
+export { t as AuthenticationError, r as ContainsCIDResponse, q as ContentType, n as FileObject, N as NetworkError, s as PinataError, o as PinataMetadata, u as ValidationError, p as VectorQueryMatch, v as containsCID, w as convertToDesiredGateway } from './gateway-tools-Cx64TJRo.mjs';
 
 type PinataConfig = {
     pinataJwt?: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DeleteResponse, V as VectorizeFileResponse, F as FileListQuery, a as FileListResponse, S as SwapCidOptions, b as SwapCidResponse, c as SwapHistoryOptions, U as UpdateFileOptions, d as FileListItem, e as VectorizeQuery, f as VectorizeQueryResponse, G as GetCIDResponse, P as PinQueueQuery, g as PinQueueResponse, O as OptimizeImageOptions, A as AccessLinkOptions, h as UploadOptions, i as UploadResponse, j as SignedUploadUrlOptions, J as JsonBody, k as UploadCIDOptions, l as PinByCIDResponse, m as PinQueueItem, C as CidVersion } from './gateway-tools-C-tdEyF2.js';
-export { t as AuthenticationError, r as ContainsCIDResponse, q as ContentType, n as FileObject, N as NetworkError, s as PinataError, o as PinataMetadata, u as ValidationError, p as VectorQueryMatch, v as containsCID, w as convertToDesiredGateway } from './gateway-tools-C-tdEyF2.js';
+import { D as DeleteResponse, V as VectorizeFileResponse, F as FileListQuery, a as FileListResponse, S as SwapCidOptions, b as SwapCidResponse, c as SwapHistoryOptions, U as UpdateFileOptions, d as FileListItem, e as VectorizeQuery, f as VectorizeQueryResponse, G as GetCIDResponse, P as PinQueueQuery, g as PinQueueResponse, O as OptimizeImageOptions, A as AccessLinkOptions, h as UploadOptions, i as UploadResponse, j as SignedUploadUrlOptions, J as JsonBody, k as UploadCIDOptions, l as PinByCIDResponse, m as PinQueueItem, C as CidVersion } from './gateway-tools-Cx64TJRo.js';
+export { t as AuthenticationError, r as ContainsCIDResponse, q as ContentType, n as FileObject, N as NetworkError, s as PinataError, o as PinataMetadata, u as ValidationError, p as VectorQueryMatch, v as containsCID, w as convertToDesiredGateway } from './gateway-tools-Cx64TJRo.js';
 
 type PinataConfig = {
     pinataJwt?: string;

package/dist/index.js

@@ -2440,8 +2440,12 @@ var createSignedUploadURL = async (config, options, network) => {
   if (options.maxFileSize) {
     payload.max_file_size = options.maxFileSize;
   }
-  if (options.mimeTypes) {
-    payload.allow_mime_types = options.mimeTypes;
+  if (options.mimeTypes || options.forDirectory) {
+    const types = new Set(options.mimeTypes ?? []);
+    if (options.forDirectory) {
+      types.add("directory");
+    }
+    payload.allow_mime_types = Array.from(types);
   }
   let endpoint = "https://uploads.pinata.cloud/v3";
   if (config.uploadUrl) {
@@ -2882,6 +2886,89 @@ var uploadFileArray = async (config, files, network, options) => {
   }
   const jwt = options?.keys || config?.pinataJwt;
   const folder = options?.metadata?.name || "folder_from_sdk";
+  let headers;
+  if (config.customHeaders && Object.keys(config.customHeaders).length > 0) {
+    headers = {
+      Authorization: `Bearer ${jwt}`,
+      ...config.customHeaders
+    };
+  } else {
+    headers = {
+      Authorization: `Bearer ${jwt}`,
+      Source: "sdk/fileArray"
+    };
+  }
+  if (options?.url) {
+    const data2 = new FormData();
+    for (const file of Array.from(files)) {
+      const path = file.webkitRelativePath || `${folder}/${file.name}`;
+      data2.append("file", file, path);
+    }
+    data2.append("network", network);
+    data2.append("name", folder);
+    if (options.groupId) {
+      data2.append("group_id", options.groupId);
+    }
+    if (options.metadata?.keyvalues) {
+      data2.append("keyvalues", JSON.stringify(options.metadata.keyvalues));
+    }
+    if (options.streamable) {
+      data2.append("streamable", "true");
+    }
+    if (options.car) {
+      data2.append("car", "true");
+    }
+    if (options.cid_version !== void 0) {
+      data2.append("cid_version", options.cid_version.toString());
+    }
+    if (options.expires_at !== void 0) {
+      data2.append("expires_at", options.expires_at.toString());
+    }
+    try {
+      const url = new URL(options.url);
+      const request = await fetch(url.toString(), {
+        method: "POST",
+        headers,
+        body: data2
+      });
+      if (!request.ok) {
+        const errorData = await request.text();
+        if (request.status === 401 || request.status === 403) {
+          throw new chunkBK3CLF3Z_js.AuthenticationError(
+            `Authentication failed: ${errorData}`,
+            request.status,
+            {
+              error: errorData,
+              code: "AUTH_ERROR",
+              metadata: {
+                requestUrl: request.url
+              }
+            }
+          );
+        }
+        throw new chunkBK3CLF3Z_js.NetworkError(`HTTP error: ${errorData}`, request.status, {
+          error: errorData,
+          code: "HTTP_ERROR",
+          metadata: {
+            requestUrl: request.url
+          }
+        });
+      }
+      const res = await request.json();
+      const resData = res.data;
+      return resData;
+    } catch (error) {
+      if (error instanceof chunkBK3CLF3Z_js.PinataError) {
+        throw error;
+      }
+      if (error instanceof Error) {
+        throw new chunkBK3CLF3Z_js.PinataError(`Error processing fileArray: ${error.message}`);
+      }
+      throw new chunkBK3CLF3Z_js.PinataError(
+        "An unknown error occurred while uploading an array of files"
+      );
+    }
+  }
   const data = new FormData();
   for (const file of Array.from(files)) {
     const path = file.webkitRelativePath || `${folder}/${file.name}`;
@@ -2901,18 +2988,6 @@ var uploadFileArray = async (config, files, network, options) => {
       cidVersion: 1
     })
   );
-  let headers;
-  if (config.customHeaders && Object.keys(config.customHeaders).length > 0) {
-    headers = {
-      Authorization: `Bearer ${jwt}`,
-      ...config.customHeaders
-    };
-  } else {
-    headers = {
-      Authorization: `Bearer ${jwt}`,
-      Source: "sdk/fileArray"
-    };
-  }
   let endpoint = "https://api.pinata.cloud/pinning/pinFileToIPFS";
   if (config.legacyUploadUrl) {
     endpoint = config.legacyUploadUrl;