pinata 1.0.6 → 1.2.0

package/dist/index.d.mts

@@ -59,9 +59,14 @@ type FileListResponse = {
     next_page_token: string;
 };
 type FileListQuery = {
+    name?: string;
+    group?: string;
+    mimeType?: string;
+    cid?: string;
+    cidPending?: boolean;
+    order?: "ASC" | "DESC";
     limit?: number;
     pageToken?: string;
-    cidPending?: boolean;
 };
 type PinJobQuery = {
     sort?: "ASC" | "DSC";
@@ -245,7 +250,7 @@ type GroupResponseItem = {
     createdAt: string;
 };
 type GroupQueryOptions = {
-    nameContains?: string;
+    name?: string;
     limit?: number;
     pageToken?: string;
     isPublic?: boolean;
@@ -325,9 +330,15 @@ declare class FilterFiles {
     private query;
     private currentPageToken;
     constructor(config: PinataConfig | undefined);
+    name(name: string): FilterFiles;
+    group(group: string): FilterFiles;
+    cid(cid: string): FilterFiles;
+    mimeType(mimeType: string): FilterFiles;
+    order(order: "ASC" | "DESC"): FilterFiles;
     limit(limit: number): FilterFiles;
     cidPending(cidPending: boolean): FilterFiles;
-    then(onfulfilled?: ((value: FileListItem[]) => any) | null): Promise<any>;
+    pageToken(pageToken: string): FilterFiles;
+    then(onfulfilled?: ((value: FileListResponse) => any) | null): Promise<any>;
     private fetchPage;
     [Symbol.asyncIterator](): AsyncGenerator<FileListItem, void, unknown>;
     all(): Promise<FileListItem[]>;
@@ -336,8 +347,24 @@ declare class Gateways {
     config: PinataConfig | undefined;
     constructor(config?: PinataConfig);
     updateConfig(newConfig: PinataConfig): void;
-    get(cid: string): Promise<GetCIDResponse>;
-    createSignedURL(options: SignedUrlOptions): Promise<string>;
+    get(cid: string): OptimizeImageGetCid;
+    createSignedURL(options: SignedUrlOptions): OptimizeImageCreateSignedURL;
+}
+declare class OptimizeImageGetCid {
+    private config;
+    private cid;
+    private options;
+    constructor(config: PinataConfig | undefined, cid: string);
+    optimizeImage(options: OptimizeImageOptions): OptimizeImageGetCid;
+    then(onfulfilled?: ((value: GetCIDResponse) => any) | null): Promise<any>;
+}
+declare class OptimizeImageCreateSignedURL {
+    private config;
+    private urlOpts;
+    private imgOpts;
+    constructor(config: PinataConfig | undefined, urlOpts: SignedUrlOptions);
+    optimizeImage(options: OptimizeImageOptions): OptimizeImageCreateSignedURL;
+    then(onfulfilled?: ((value: string) => any) | null): Promise<any>;
 }
 declare class Keys {
     config: PinataConfig | undefined;
@@ -375,9 +402,11 @@ declare class FilterGroups {
     private query;
     private nextPageToken;
     constructor(config: PinataConfig | undefined);
+    name(name: string): FilterGroups;
     limit(limit: number): FilterGroups;
     isPublic(isPublic: boolean): FilterGroups;
-    then(onfulfilled?: ((value: GroupResponseItem[]) => any) | null): Promise<GroupResponseItem[]>;
+    pageToken(pageToken: string): FilterGroups;
+    then(onfulfilled?: ((value: GroupListResponse) => any) | null): Promise<GroupListResponse>;
     private fetchPage;
     [Symbol.asyncIterator](): AsyncGenerator<GroupResponseItem, void, unknown>;
     all(): Promise<GroupResponseItem[]>;

package/dist/index.d.ts

@@ -59,9 +59,14 @@ type FileListResponse = {
     next_page_token: string;
 };
 type FileListQuery = {
+    name?: string;
+    group?: string;
+    mimeType?: string;
+    cid?: string;
+    cidPending?: boolean;
+    order?: "ASC" | "DESC";
     limit?: number;
     pageToken?: string;
-    cidPending?: boolean;
 };
 type PinJobQuery = {
     sort?: "ASC" | "DSC";
@@ -245,7 +250,7 @@ type GroupResponseItem = {
     createdAt: string;
 };
 type GroupQueryOptions = {
-    nameContains?: string;
+    name?: string;
     limit?: number;
     pageToken?: string;
     isPublic?: boolean;
@@ -325,9 +330,15 @@ declare class FilterFiles {
     private query;
     private currentPageToken;
     constructor(config: PinataConfig | undefined);
+    name(name: string): FilterFiles;
+    group(group: string): FilterFiles;
+    cid(cid: string): FilterFiles;
+    mimeType(mimeType: string): FilterFiles;
+    order(order: "ASC" | "DESC"): FilterFiles;
     limit(limit: number): FilterFiles;
     cidPending(cidPending: boolean): FilterFiles;
-    then(onfulfilled?: ((value: FileListItem[]) => any) | null): Promise<any>;
+    pageToken(pageToken: string): FilterFiles;
+    then(onfulfilled?: ((value: FileListResponse) => any) | null): Promise<any>;
     private fetchPage;
     [Symbol.asyncIterator](): AsyncGenerator<FileListItem, void, unknown>;
     all(): Promise<FileListItem[]>;
@@ -336,8 +347,24 @@ declare class Gateways {
     config: PinataConfig | undefined;
     constructor(config?: PinataConfig);
     updateConfig(newConfig: PinataConfig): void;
-    get(cid: string): Promise<GetCIDResponse>;
-    createSignedURL(options: SignedUrlOptions): Promise<string>;
+    get(cid: string): OptimizeImageGetCid;
+    createSignedURL(options: SignedUrlOptions): OptimizeImageCreateSignedURL;
+}
+declare class OptimizeImageGetCid {
+    private config;
+    private cid;
+    private options;
+    constructor(config: PinataConfig | undefined, cid: string);
+    optimizeImage(options: OptimizeImageOptions): OptimizeImageGetCid;
+    then(onfulfilled?: ((value: GetCIDResponse) => any) | null): Promise<any>;
+}
+declare class OptimizeImageCreateSignedURL {
+    private config;
+    private urlOpts;
+    private imgOpts;
+    constructor(config: PinataConfig | undefined, urlOpts: SignedUrlOptions);
+    optimizeImage(options: OptimizeImageOptions): OptimizeImageCreateSignedURL;
+    then(onfulfilled?: ((value: string) => any) | null): Promise<any>;
 }
 declare class Keys {
     config: PinataConfig | undefined;
@@ -375,9 +402,11 @@ declare class FilterGroups {
     private query;
     private nextPageToken;
     constructor(config: PinataConfig | undefined);
+    name(name: string): FilterGroups;
     limit(limit: number): FilterGroups;
     isPublic(isPublic: boolean): FilterGroups;
-    then(onfulfilled?: ((value: GroupResponseItem[]) => any) | null): Promise<GroupResponseItem[]>;
+    pageToken(pageToken: string): FilterGroups;
+    then(onfulfilled?: ((value: GroupListResponse) => any) | null): Promise<GroupListResponse>;
     private fetchPage;
     [Symbol.asyncIterator](): AsyncGenerator<GroupResponseItem, void, unknown>;
     all(): Promise<GroupResponseItem[]>;

package/dist/index.js

@@ -443,9 +443,19 @@ var listFiles = async (config, options) => {
   }
   const params = new URLSearchParams();
   if (options) {
-    const { limit, pageToken, cidPending } = options;
+    const { name, group, cid, order, limit, mimeType, pageToken, cidPending } = options;
     if (limit)
       params.append("limit", limit.toString());
+    if (name)
+      params.append("name", name);
+    if (group)
+      params.append("group", group);
+    if (cid)
+      params.append("cid", cid);
+    if (mimeType)
+      params.append("mimeType", mimeType);
+    if (order)
+      params.append("order", order);
     if (pageToken)
       params.append("pageToken", pageToken);
     if (cidPending)
@@ -557,13 +567,41 @@ var updateFile = async (config, options) => {
 };
 
 // src/core/gateway/getCid.ts
-var getCid = async (config, cid) => {
+var getCid = async (config, cid, options) => {
   if (!config) {
     throw new ValidationError("Pinata configuration is missing");
   }
   let data;
   let newUrl = `${config?.pinataGateway}/files/${cid}`;
   const params = new URLSearchParams();
+  if (options) {
+    if (options.width)
+      params.append("img-width", options.width.toString());
+    if (options.height)
+      params.append("img-height", options.height.toString());
+    if (options.dpr)
+      params.append("img-dpr", options.dpr.toString());
+    if (options.fit)
+      params.append("img-fit", options.fit);
+    if (options.gravity)
+      params.append("img-gravity", options.gravity);
+    if (options.quality)
+      params.append("img-quality", options.quality.toString());
+    if (options.format)
+      params.append("img-format", options.format);
+    if (options.animation !== void 0)
+      params.append("img-anim", options.animation.toString());
+    if (options.sharpen)
+      params.append("img-sharpen", options.sharpen.toString());
+    if (options.onError === true)
+      params.append("img-onerror", "redirect");
+    if (options.metadata)
+      params.append("img-metadata", options.metadata);
+  }
+  const queryString = params.toString();
+  if (queryString) {
+    newUrl += `?${queryString}`;
+  }
   const date = Math.floor((/* @__PURE__ */ new Date()).getTime() / 1e3);
   const payload = JSON.stringify({
     url: newUrl,
@@ -571,17 +609,18 @@ var getCid = async (config, cid) => {
     expires: 30,
     method: "GET"
   });
-  const signedUrlRequest = await fetch(
-    "https://api.pinata.cloud/v3/files/sign",
-    {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${config?.pinataJwt}`
-      },
-      body: payload
-    }
-  );
+  let endpoint = "https://api.pinata.cloud/v3";
+  if (config.endpointUrl) {
+    endpoint = config.endpointUrl;
+  }
+  const signedUrlRequest = await fetch(`${endpoint}/files/sign`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config?.pinataJwt}`
+    },
+    body: payload
+  });
   const signedUrl = await signedUrlRequest.json();
   try {
     const request = await fetch(signedUrl.data);
@@ -894,13 +933,13 @@ var listGroups = async (config, options) => {
   }
   const params = new URLSearchParams();
   if (options) {
-    const { pageToken, nameContains, limit, isPublic } = options;
+    const { pageToken, name, limit, isPublic } = options;
     if (pageToken)
       params.append("pageToken", pageToken.toString());
     if (isPublic)
       params.append("isPublic", isPublic.toString());
-    if (nameContains !== void 0)
-      params.append("nameContains", nameContains.toString());
+    if (name)
+      params.append("name", name);
     if (limit !== void 0)
       params.append("limit", limit.toString());
   }
@@ -1111,11 +1150,40 @@ var deleteGroup = async (config, options) => {
 };
 
 // src/core/gateway/createSignedURL.ts
-var createSignedURL = async (config, options) => {
+var createSignedURL = async (config, options, imgOpts) => {
   if (!config) {
     throw new ValidationError("Pinata configuration is missing");
   }
   let newUrl = `${config?.pinataGateway}/files/${options.cid}`;
+  const params = new URLSearchParams();
+  if (imgOpts) {
+    if (imgOpts.width)
+      params.append("img-width", imgOpts.width.toString());
+    if (imgOpts.height)
+      params.append("img-height", imgOpts.height.toString());
+    if (imgOpts.dpr)
+      params.append("img-dpr", imgOpts.dpr.toString());
+    if (imgOpts.fit)
+      params.append("img-fit", imgOpts.fit);
+    if (imgOpts.gravity)
+      params.append("img-gravity", imgOpts.gravity);
+    if (imgOpts.quality)
+      params.append("img-quality", imgOpts.quality.toString());
+    if (imgOpts.format)
+      params.append("img-format", imgOpts.format);
+    if (imgOpts.animation !== void 0)
+      params.append("img-anim", imgOpts.animation.toString());
+    if (imgOpts.sharpen)
+      params.append("img-sharpen", imgOpts.sharpen.toString());
+    if (imgOpts.onError === true)
+      params.append("img-onerror", "redirect");
+    if (imgOpts.metadata)
+      params.append("img-metadata", imgOpts.metadata);
+  }
+  const queryString = params.toString();
+  if (queryString) {
+    newUrl += `?${queryString}`;
+  }
   const date = options?.date || Math.floor((/* @__PURE__ */ new Date()).getTime() / 1e3);
   const payload = JSON.stringify({
     url: newUrl,
@@ -1295,6 +1363,26 @@ var FilterFiles = class {
     this.query = {};
     this.config = config;
   }
+  name(name) {
+    this.query.name = name;
+    return this;
+  }
+  group(group) {
+    this.query.group = group;
+    return this;
+  }
+  cid(cid) {
+    this.query.cid = cid;
+    return this;
+  }
+  mimeType(mimeType) {
+    this.query.mimeType = mimeType;
+    return this;
+  }
+  order(order) {
+    this.query.order = order;
+    return this;
+  }
   limit(limit) {
     this.query.limit = limit;
     return this;
@@ -1303,6 +1391,10 @@ var FilterFiles = class {
     this.query.cidPending = cidPending;
     return this;
   }
+  pageToken(pageToken) {
+    this.query.pageToken = pageToken;
+    return this;
+  }
   then(onfulfilled) {
     return this.fetchPage().then(onfulfilled);
   }
@@ -1312,7 +1404,7 @@ var FilterFiles = class {
     }
     const response = await listFiles(this.config, this.query);
     this.currentPageToken = response.next_page_token;
-    return response.files;
+    return response;
   }
   // // rate limit, hopefully temporary?
   // private async rateLimit(): Promise<void> {
@@ -1331,7 +1423,7 @@ var FilterFiles = class {
   async *[Symbol.asyncIterator]() {
     while (true) {
       const items = await this.fetchPage();
-      for (const item of items) {
+      for (const item of items.files) {
         yield item;
       }
       if (!this.currentPageToken) {
@@ -1355,10 +1447,10 @@ var Gateways = class {
     this.config = newConfig;
   }
   get(cid) {
-    return getCid(this.config, cid);
+    return new OptimizeImageGetCid(this.config, cid);
   }
   createSignedURL(options) {
-    return createSignedURL(this.config, options);
+    return new OptimizeImageCreateSignedURL(this.config, options);
   }
   // get(cid: string): OptimizeImage {
   // 	return new OptimizeImage(this.config, cid);
@@ -1415,6 +1507,36 @@ var Gateways = class {
   // 	return deleteSwap(this.config, cid);
   // }
 };
+var OptimizeImageGetCid = class {
+  constructor(config, cid) {
+    this.options = {};
+    this.config = config;
+    this.cid = cid;
+  }
+  optimizeImage(options) {
+    this.options = { ...this.options, ...options };
+    return this;
+  }
+  then(onfulfilled) {
+    return getCid(this.config, this.cid, this.options).then(onfulfilled);
+  }
+};
+var OptimizeImageCreateSignedURL = class {
+  constructor(config, urlOpts) {
+    this.imgOpts = {};
+    this.config = config;
+    this.urlOpts = urlOpts;
+  }
+  optimizeImage(options) {
+    this.imgOpts = { ...this.imgOpts, ...options };
+    return this;
+  }
+  then(onfulfilled) {
+    return createSignedURL(this.config, this.urlOpts, this.imgOpts).then(
+      onfulfilled
+    );
+  }
+};
 var Keys = class {
   constructor(config) {
     this.config = formatConfig(config);
@@ -1536,10 +1658,10 @@ var FilterGroups = class {
     this.query = {};
     this.config = config;
   }
-  // name(nameContains: string): FilterGroups {
-  // 	this.query.nameContains = nameContains;
-  // 	return this;
-  // }
+  name(name) {
+    this.query.name = name;
+    return this;
+  }
   limit(limit) {
     this.query.limit = limit;
     return this;
@@ -1548,10 +1670,14 @@ var FilterGroups = class {
     this.query.isPublic = isPublic;
     return this;
   }
+  pageToken(pageToken) {
+    this.query.pageToken = pageToken;
+    return this;
+  }
   then(onfulfilled) {
     return this.fetchPage().then((response) => {
       this.nextPageToken = response.next_page_token;
-      return response.groups;
+      return response;
     }).then(onfulfilled);
   }
   async fetchPage() {