@lumeweb/pinner 0.1.0 → 0.1.1

package/dist/esm/adapters/pinata/legacy/adapter.d.ts

@@ -0,0 +1,74 @@
+import { Pinner } from "../../../pinner.js";
+import { FileListQuery, FileListResponse, PinJobQuery, PinJobResponse, PinataConfig, SignedUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TopAnalyticsQuery, TopAnalyticsResponse, UploadOptions, UploadResponse } from "../shared/types.js";
+
+//#region src/adapters/pinata/legacy/adapter.d.ts
+
+/**
+ * Pinata 1.x Legacy Adapter Interface
+ * Matches Pinata SDK 1.x API exactly
+ */
+interface PinataLegacyAdapter {
+  /**
+   * Upload a file to IPFS
+   */
+  pinFileToIPFS(file: File, options?: UploadOptions): Promise<UploadResponse>;
+  /**
+   * Upload JSON data to IPFS
+   */
+  pinJSONToIPFS(data: any, options?: UploadOptions): Promise<UploadResponse>;
+  /**
+   * Pin content by CID
+   */
+  pinByHash(cid: string, options?: UploadOptions): Promise<UploadResponse>;
+  /**
+   * List pinned files
+   */
+  pinList(query?: FileListQuery): Promise<FileListResponse>;
+  /**
+   * Unpin content by CID
+   */
+  unpin(cid: string): Promise<{
+    message: string;
+  }>;
+  /**
+   * Update pin metadata
+   */
+  hashMetadata(cid: string, metadata: Record<string, string>): Promise<{
+    message: string;
+  }>;
+  /**
+   * Create signed URL for private IPFS files
+   */
+  createSignedURL(options: SignedUrlOptions): Promise<string>;
+  /**
+   * Get pin jobs
+   */
+  pinJobs(query?: PinJobQuery): Promise<PinJobResponse>;
+  /**
+   * Get top usage analytics
+   */
+  topUsageAnalytics(query: TopAnalyticsQuery): Promise<TopAnalyticsResponse>;
+  /**
+   * Get date interval analytics
+   */
+  dateIntervalAnalytics(query: TimeIntervalAnalyticsQuery): Promise<TimeIntervalAnalyticsResponse>;
+  /**
+   * Swap CID
+   */
+  swapCid(options: SwapCidOptions): Promise<SwapCidResponse>;
+  /**
+   * Get swap history
+   */
+  swapHistory(options: SwapHistoryOptions): Promise<SwapCidResponse[]>;
+}
+/**
+ * Create Pinata 1.x Legacy Adapter
+ *
+ * @param pinner - Pinner client instance
+ * @param config - Pinata configuration
+ * @returns PinataLegacyAdapter
+ */
+declare function pinataLegacyAdapter(pinner: Pinner, config?: PinataConfig): PinataLegacyAdapter;
+//#endregion
+export { PinataLegacyAdapter, pinataLegacyAdapter };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/esm/adapters/pinata/legacy/adapter.js

@@ -0,0 +1,83 @@
+import { DEFAULT_GATEWAY } from "../../../types/constants.js";
+import { createFileListItem, createPinJobItem, createUploadResponse, notSupported, parseCID } from "../shared/utils.js";
+
+//#region src/adapters/pinata/legacy/adapter.ts
+/**
+* Create Pinata 1.x Legacy Adapter
+*
+* @param pinner - Pinner client instance
+* @param config - Pinata configuration
+* @returns PinataLegacyAdapter
+*/
+function pinataLegacyAdapter(pinner, config) {
+	return {
+		async pinFileToIPFS(file, options) {
+			return createUploadResponse(await pinner.uploadAndWait(file, {
+				name: options?.metadata?.name,
+				keyvalues: options?.metadata?.keyvalues
+			}), file.name);
+		},
+		async pinJSONToIPFS(data, options) {
+			const jsonString = JSON.stringify(data);
+			const file = new File([jsonString], options?.metadata?.name || "data.json", { type: "application/json" });
+			return createUploadResponse(await pinner.uploadAndWait(file, {
+				name: options?.metadata?.name,
+				keyvalues: options?.metadata?.keyvalues
+			}), file.name);
+		},
+		async pinByHash(cid, options) {
+			const cidObj = parseCID(cid);
+			const generator = await pinner.pinByHash(cidObj, {
+				name: options?.metadata?.name,
+				metadata: options?.metadata?.keyvalues
+			});
+			for await (const _ of generator);
+			const pin = await pinner.getPinStatus(cidObj);
+			return createUploadResponse({
+				cid: pin.cid.toString(),
+				size: pin.size || 0,
+				createdAt: pin.created
+			}, pin.name || "");
+		},
+		async pinList(query) {
+			return {
+				files: (await pinner.listPins({ limit: query?.limit })).map(createFileListItem),
+				next_page_token: ""
+			};
+		},
+		async unpin(cid) {
+			await pinner.unpin(cid);
+			return { message: `Unpinned ${cid}` };
+		},
+		async hashMetadata(cid, metadata) {
+			await pinner.setPinMetadata(cid, metadata);
+			return { message: `Updated metadata for ${cid}` };
+		},
+		async createSignedURL(options) {
+			return `${config?.pinataGateway || DEFAULT_GATEWAY}/ipfs/${options.cid}`;
+		},
+		async pinJobs(query) {
+			return { rows: (await pinner.listPins({ limit: query?.limit })).map(createPinJobItem) };
+		},
+		async topUsageAnalytics(query) {
+			return { data: [] };
+		},
+		async dateIntervalAnalytics(query) {
+			return {
+				total_requests: 0,
+				total_bandwidth: 0,
+				time_periods: []
+			};
+		},
+		async swapCid(options) {
+			notSupported("Swap CID");
+		},
+		async swapHistory(options) {
+			return [];
+		}
+	};
+}
+
+//#endregion
+export { pinataLegacyAdapter };
+//# sourceMappingURL=adapter.js.map

package/dist/esm/adapters/pinata/legacy/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":[],"sources":["../../../../../src/adapters/pinata/legacy/adapter.ts"],"sourcesContent":["/**\n * Pinata SDK 1.x Legacy Adapter\n * Provides compatibility with Pinata SDK 1.x API\n *\n * Source: https://github.com/PinataCloud/pinata/commit/c141177ff3036e46fa7b95fcc68c159b58817836\n * - src/core/pinataSDK.ts\n * - src/core/types.ts\n *\n * Copyright © 2024 Pinata Cloud Technologies\n * Type definitions and API interfaces adapted from Pinata SDK for compatibility.\n * Original Pinata SDK: https://github.com/PinataCloud/pinata\n */\n\nimport type { Pinner } from \"@/pinner\";\nimport type {\n\tPinataConfig,\n\tUploadResponse,\n\tUploadOptions,\n\tFileListResponse,\n\tFileListQuery,\n\tPinJobResponse,\n\tPinJobQuery,\n\tDeleteResponse,\n\tPinataMetadata,\n\tSignedUrlOptions,\n\tTopAnalyticsQuery,\n\tTopAnalyticsResponse,\n\tTimeIntervalAnalyticsQuery,\n\tTimeIntervalAnalyticsResponse,\n\tSwapCidOptions,\n\tSwapCidResponse,\n\tSwapHistoryOptions,\n} from \"../shared/types\";\nimport { parseCID, createUploadResponse, createFileListItem, createPinJobItem, notSupported } from \"../shared/utils\";\nimport { DEFAULT_GATEWAY } from \"@/types/constants\";\n\n/**\n * Pinata 1.x Legacy Adapter Interface\n * Matches Pinata SDK 1.x API exactly\n */\nexport interface PinataLegacyAdapter {\n\t/**\n\t * Upload a file to IPFS\n\t */\n\tpinFileToIPFS(file: File, options?: UploadOptions): Promise<UploadResponse>;\n\n\t/**\n\t * Upload JSON data to IPFS\n\t */\n\tpinJSONToIPFS(data: any, options?: UploadOptions): Promise<UploadResponse>;\n\n\t/**\n\t * Pin content by CID\n\t */\n\tpinByHash(cid: string, options?: UploadOptions): Promise<UploadResponse>;\n\n\t/**\n\t * List pinned files\n\t */\n\tpinList(query?: FileListQuery): Promise<FileListResponse>;\n\n\t/**\n\t * Unpin content by CID\n\t */\n\tunpin(cid: string): Promise<{ message: string }>;\n\n\t/**\n\t * Update pin metadata\n\t */\n\thashMetadata(cid: string, metadata: Record<string, string>): Promise<{ message: string }>;\n\n\t/**\n\t * Create signed URL for private IPFS files\n\t */\n\tcreateSignedURL(options: SignedUrlOptions): Promise<string>;\n\n\t/**\n\t * Get pin jobs\n\t */\n\tpinJobs(query?: PinJobQuery): Promise<PinJobResponse>;\n\n\t/**\n\t * Get top usage analytics\n\t */\n\ttopUsageAnalytics(query: TopAnalyticsQuery): Promise<TopAnalyticsResponse>;\n\n\t/**\n\t * Get date interval analytics\n\t */\n\tdateIntervalAnalytics(\n\t\tquery: TimeIntervalAnalyticsQuery,\n\t): Promise<TimeIntervalAnalyticsResponse>;\n\n\t/**\n\t * Swap CID\n\t */\n\tswapCid(options: SwapCidOptions): Promise<SwapCidResponse>;\n\n\t/**\n\t * Get swap history\n\t */\n\tswapHistory(options: SwapHistoryOptions): Promise<SwapCidResponse[]>;\n}\n\n/**\n * Create Pinata 1.x Legacy Adapter\n *\n * @param pinner - Pinner client instance\n * @param config - Pinata configuration\n * @returns PinataLegacyAdapter\n */\nexport function pinataLegacyAdapter(\n\tpinner: Pinner,\n\tconfig?: PinataConfig,\n): PinataLegacyAdapter {\n\treturn {\n\t\t/**\n\t\t * Pin a file to IPFS\n\t\t */\n\t\tasync pinFileToIPFS(\n\t\t\tfile: File,\n\t\t\toptions?: UploadOptions,\n\t\t): Promise<UploadResponse> {\n\t\t\tconst result = await pinner.uploadAndWait(file, {\n\t\t\t\tname: options?.metadata?.name,\n\t\t\t\tkeyvalues: options?.metadata?.keyvalues,\n\t\t\t});\n\n\t\t\treturn createUploadResponse(result, file.name);\n\t\t},\n\n\t\t/**\n\t\t * Pin JSON data to IPFS\n\t\t */\n\t\tasync pinJSONToIPFS(\n\t\t\tdata: any,\n\t\t\toptions?: UploadOptions,\n\t\t): Promise<UploadResponse> {\n\t\t\t// Convert JSON to File\n\t\t\tconst jsonString = JSON.stringify(data);\n\t\t\tconst file = new File(\n\t\t\t\t[jsonString],\n\t\t\t\toptions?.metadata?.name || \"data.json\",\n\t\t\t\t{ type: \"application/json\" },\n\t\t\t);\n\n\t\t\tconst result = await pinner.uploadAndWait(file, {\n\t\t\t\tname: options?.metadata?.name,\n\t\t\t\tkeyvalues: options?.metadata?.keyvalues,\n\t\t\t});\n\n\t\t\treturn createUploadResponse(result, file.name);\n\t\t},\n\n\t\t/**\n\t\t * Pin content by CID\n\t\t */\n\t\tasync pinByHash(\n\t\t\tcid: string,\n\t\t\toptions?: UploadOptions,\n\t\t): Promise<UploadResponse> {\n\t\t\tconst cidObj = parseCID(cid);\n\t\t\tconst generator = await pinner.pinByHash(cidObj, {\n\t\t\t\tname: options?.metadata?.name,\n\t\t\t\tmetadata: options?.metadata?.keyvalues,\n\t\t\t});\n\n\t\t\tfor await (const _ of generator) {\n\t\t\t\t// Wait for pin to complete\n\t\t\t}\n\n\t\t\tconst pin = await pinner.getPinStatus(cidObj);\n\t\t\treturn createUploadResponse(\n\t\t\t\t{\n\t\t\t\t\tcid: pin.cid.toString(),\n\t\t\t\t\tsize: pin.size || 0,\n\t\t\t\t\tcreatedAt: pin.created,\n\t\t\t\t},\n\t\t\t\tpin.name || \"\",\n\t\t\t);\n\t\t},\n\n\t\t/**\n\t\t * List pinned files\n\t\t */\n\t\tasync pinList(query?: FileListQuery): Promise<FileListResponse> {\n\t\t\tconst pins = await pinner.listPins({\n\t\t\t\tlimit: query?.limit,\n\t\t\t});\n\n\t\t\treturn {\n\t\t\t\tfiles: pins.map(createFileListItem),\n\t\t\t\tnext_page_token: \"\",\n\t\t\t};\n\t\t},\n\n\t\t/**\n\t\t * Unpin content\n\t\t */\n\t\tasync unpin(cid: string): Promise<{ message: string }> {\n\t\t\tawait pinner.unpin(cid);\n\t\t\treturn { message: `Unpinned ${cid}` };\n\t\t},\n\n\t\t/**\n\t\t * Update pin metadata\n\t\t */\n\t\tasync hashMetadata(\n\t\t\tcid: string,\n\t\t\tmetadata: Record<string, string>,\n\t\t): Promise<{ message: string }> {\n\t\t\tawait pinner.setPinMetadata(cid, metadata);\n\t\t\treturn { message: `Updated metadata for ${cid}` };\n\t\t},\n\n\t\t/**\n\t\t * Create signed URL (not fully supported in Pinner)\n\t\t * Returns a gateway URL instead\n\t\t */\n\t\tasync createSignedURL(options: SignedUrlOptions): Promise<string> {\n\t\t\t// Pinner doesn't support signed URLs for private files\n\t\t\t// Return a gateway URL as fallback\n\t\t\tconst gateway = config?.pinataGateway || DEFAULT_GATEWAY;\n\t\t\treturn `${gateway}/ipfs/${options.cid}`;\n\t\t},\n\n\t\t/**\n\t\t * Get pin jobs\n\t\t */\n\t\tasync pinJobs(query?: PinJobQuery): Promise<PinJobResponse> {\n\t\t\tconst pins = await pinner.listPins({\n\t\t\t\tlimit: query?.limit,\n\t\t\t});\n\n\t\t\treturn {\n\t\t\t\trows: pins.map(createPinJobItem),\n\t\t\t};\n\t\t},\n\n\t\t/**\n\t\t * Get top usage analytics (not supported in Pinner)\n\t\t * Returns empty data\n\t\t */\n\t\tasync topUsageAnalytics(\n\t\t\tquery: TopAnalyticsQuery,\n\t\t): Promise<TopAnalyticsResponse> {\n\t\t\t// Pinner doesn't support analytics\n\t\t\treturn {\n\t\t\t\tdata: [],\n\t\t\t};\n\t\t},\n\n\t\t/**\n\t\t * Get date interval analytics (not supported in Pinner)\n\t\t * Returns empty data\n\t\t */\n\t\tasync dateIntervalAnalytics(\n\t\t\tquery: TimeIntervalAnalyticsQuery,\n\t\t): Promise<TimeIntervalAnalyticsResponse> {\n\t\t\t// Pinner doesn't support analytics\n\t\t\treturn {\n\t\t\t\ttotal_requests: 0,\n\t\t\t\ttotal_bandwidth: 0,\n\t\t\t\ttime_periods: [],\n\t\t\t};\n\t\t},\n\n\t\t/**\n\t\t * Swap CID (not supported in Pinner)\n\t\t * Returns error\n\t\t */\n\t\tasync swapCid(options: SwapCidOptions): Promise<SwapCidResponse> {\n\t\t\tnotSupported(\"Swap CID\");\n\t\t},\n\n\t\t/**\n\t\t * Get swap history (not supported in Pinner)\n\t\t * Returns empty array\n\t\t */\n\t\tasync swapHistory(options: SwapHistoryOptions): Promise<SwapCidResponse[]> {\n\t\t\t// Pinner doesn't support swaps\n\t\t\treturn [];\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;AA+GA,SAAgB,oBACf,QACA,QACsB;AACtB,QAAO;EAIN,MAAM,cACL,MACA,SAC0B;AAM1B,UAAO,qBALQ,MAAM,OAAO,cAAc,MAAM;IAC/C,MAAM,SAAS,UAAU;IACzB,WAAW,SAAS,UAAU;IAC9B,CAAC,EAEkC,KAAK,KAAK;;EAM/C,MAAM,cACL,MACA,SAC0B;GAE1B,MAAM,aAAa,KAAK,UAAU,KAAK;GACvC,MAAM,OAAO,IAAI,KAChB,CAAC,WAAW,EACZ,SAAS,UAAU,QAAQ,aAC3B,EAAE,MAAM,oBAAoB,CAC5B;AAOD,UAAO,qBALQ,MAAM,OAAO,cAAc,MAAM;IAC/C,MAAM,SAAS,UAAU;IACzB,WAAW,SAAS,UAAU;IAC9B,CAAC,EAEkC,KAAK,KAAK;;EAM/C,MAAM,UACL,KACA,SAC0B;GAC1B,MAAM,SAAS,SAAS,IAAI;GAC5B,MAAM,YAAY,MAAM,OAAO,UAAU,QAAQ;IAChD,MAAM,SAAS,UAAU;IACzB,UAAU,SAAS,UAAU;IAC7B,CAAC;AAEF,cAAW,MAAM,KAAK;GAItB,MAAM,MAAM,MAAM,OAAO,aAAa,OAAO;AAC7C,UAAO,qBACN;IACC,KAAK,IAAI,IAAI,UAAU;IACvB,MAAM,IAAI,QAAQ;IAClB,WAAW,IAAI;IACf,EACD,IAAI,QAAQ,GACZ;;EAMF,MAAM,QAAQ,OAAkD;AAK/D,UAAO;IACN,QALY,MAAM,OAAO,SAAS,EAClC,OAAO,OAAO,OACd,CAAC,EAGW,IAAI,mBAAmB;IACnC,iBAAiB;IACjB;;EAMF,MAAM,MAAM,KAA2C;AACtD,SAAM,OAAO,MAAM,IAAI;AACvB,UAAO,EAAE,SAAS,YAAY,OAAO;;EAMtC,MAAM,aACL,KACA,UAC+B;AAC/B,SAAM,OAAO,eAAe,KAAK,SAAS;AAC1C,UAAO,EAAE,SAAS,wBAAwB,OAAO;;EAOlD,MAAM,gBAAgB,SAA4C;AAIjE,UAAO,GADS,QAAQ,iBAAiB,gBACvB,QAAQ,QAAQ;;EAMnC,MAAM,QAAQ,OAA8C;AAK3D,UAAO,EACN,OALY,MAAM,OAAO,SAAS,EAClC,OAAO,OAAO,OACd,CAAC,EAGU,IAAI,iBAAiB,EAChC;;EAOF,MAAM,kBACL,OACgC;AAEhC,UAAO,EACN,MAAM,EAAE,EACR;;EAOF,MAAM,sBACL,OACyC;AAEzC,UAAO;IACN,gBAAgB;IAChB,iBAAiB;IACjB,cAAc,EAAE;IAChB;;EAOF,MAAM,QAAQ,SAAmD;AAChE,gBAAa,WAAW;;EAOzB,MAAM,YAAY,SAAyD;AAE1E,UAAO,EAAE;;EAEV"}

package/dist/esm/adapters/pinata/legacy/index.d.ts

@@ -0,0 +1 @@
+import { PinataLegacyAdapter, pinataLegacyAdapter } from "./adapter.js";

package/dist/esm/adapters/pinata/legacy/index.js

@@ -0,0 +1 @@
+import { pinataLegacyAdapter } from "./adapter.js";

package/dist/esm/adapters/pinata/shared/index.d.ts

@@ -0,0 +1,2 @@
+import { AnalyticsQuery, FileListItem, FileListQuery, FileListResponse, PinJobItem, PinJobQuery, PinJobResponse, PinataConfig, PinataMetadata, SignedUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TimePeriodItem, TopAnalyticsItem, TopAnalyticsQuery, TopAnalyticsResponse, UploadOptions, UploadResponse } from "./types.js";
+import "./utils.js";

package/dist/esm/adapters/pinata/shared/index.js

@@ -0,0 +1 @@
+import { createFileListItem, createPinJobItem, createUploadResponse, notSupported, parseCID } from "./utils.js";

package/dist/esm/adapters/pinata/shared/types.d.ts

@@ -0,0 +1,218 @@
+//#region src/adapters/pinata/shared/types.d.ts
+/**
+ * Pinata SDK 1.x Types
+ * Source: https://github.com/PinataCloud/pinata/commit/c141177ff3036e46fa7b95fcc68c159b58817836
+ * - src/core/types.ts
+ *
+ * Copyright © 2024 Pinata Cloud Technologies
+ * Type definitions adapted from Pinata SDK for compatibility.
+ * Original Pinata SDK: https://github.com/PinataCloud/pinata
+ */
+/**
+ * Pinata configuration options
+ */
+type PinataConfig = {
+  pinataJwt?: string;
+  pinataGateway?: string;
+  pinataGatewayKey?: string;
+  customHeaders?: Record<string, string>;
+  endpointUrl?: string;
+  uploadUrl?: string;
+};
+/**
+ * Upload response from Pinata
+ */
+type UploadResponse = {
+  id: string;
+  name: string;
+  cid: string;
+  size: number;
+  created_at: string;
+  number_of_files: number;
+  mime_type: string;
+  user_id: string;
+  group_id: string | null;
+  is_duplicate: true | null;
+  vectorized: true | null;
+};
+/**
+ * Pinata metadata options
+ */
+type PinataMetadata = {
+  name?: string;
+  keyvalues?: Record<string, string>;
+};
+/**
+ * Upload options
+ */
+type UploadOptions = {
+  metadata?: PinataMetadata;
+  keys?: string;
+  groupId?: string;
+  vectorize?: boolean;
+  url?: string;
+};
+/**
+ * File list item
+ */
+type FileListItem = {
+  id: string;
+  name: string | null;
+  cid: "pending" | string;
+  size: number;
+  number_of_files: number;
+  mime_type: string;
+  keyvalues: Record<string, string>;
+  group_id: string | null;
+  created_at: string;
+};
+/**
+ * File list response
+ */
+type FileListResponse = {
+  files: FileListItem[];
+  next_page_token: string;
+};
+/**
+ * File list query options
+ */
+type FileListQuery = {
+  name?: string;
+  group?: string;
+  noGroup?: boolean;
+  mimeType?: string;
+  cid?: string;
+  cidPending?: boolean;
+  metadata?: Record<string, string>;
+  order?: "ASC" | "DESC";
+  limit?: number;
+  pageToken?: number;
+};
+/**
+ * Pin job query options
+ */
+type PinJobQuery = {
+  sort?: "ASC" | "DSC";
+  status?: "prechecking" | "retrieving" | "expired" | "over_free_limit" | "over_max_size" | "invalid_object" | "bad_host_node";
+  ipfs_pin_hash?: string;
+  limit?: number;
+  offset?: number;
+};
+/**
+ * Pin job item
+ */
+type PinJobItem = {
+  id: string;
+  ipfs_pin_hash: string;
+  date_queued: string;
+  name: string;
+  status: string;
+  keyvalues: any;
+  host_nodes: string[];
+  pin_policy: {
+    regions: {
+      id: string;
+      desiredReplicationCount: number;
+    }[];
+    version: number;
+  };
+};
+/**
+ * Pin job response
+ */
+type PinJobResponse = {
+  rows: PinJobItem[];
+};
+/**
+ * Signed URL options
+ */
+type SignedUrlOptions = {
+  cid: string;
+  date?: number;
+  expires: number;
+  gateway?: string;
+};
+/**
+ * Analytics query options
+ */
+type AnalyticsQuery = {
+  gateway_domain: string;
+  start_date: string;
+  end_date: string;
+  cid?: string;
+  file_name?: string;
+  user_agent?: string;
+  country?: string;
+  region?: string;
+  referer?: string;
+  limit?: number;
+  sort_order?: "asc" | "desc";
+};
+/**
+ * Top analytics query options
+ */
+type TopAnalyticsQuery = AnalyticsQuery & {
+  sort_by: "requests" | "bandwidth";
+  attribute: "cid" | "country" | "region" | "user_agent" | "referer" | "file_name";
+};
+/**
+ * Top analytics response
+ */
+type TopAnalyticsResponse = {
+  data: TopAnalyticsItem[];
+};
+/**
+ * Top analytics item
+ */
+type TopAnalyticsItem = {
+  value: string;
+  requests: number;
+  bandwidth: number;
+};
+/**
+ * Time interval analytics query options
+ */
+type TimeIntervalAnalyticsQuery = AnalyticsQuery & {
+  sort_by?: "requests" | "bandwidth";
+  date_interval: "day" | "week";
+};
+/**
+ * Time period item
+ */
+type TimePeriodItem = {
+  period_start_time: string;
+  requests: number;
+  bandwidth: number;
+};
+/**
+ * Time interval analytics response
+ */
+type TimeIntervalAnalyticsResponse = {
+  total_requests: number;
+  total_bandwidth: number;
+  time_periods: TimePeriodItem[];
+};
+/**
+ * Swap CID options
+ */
+type SwapCidOptions = {
+  cid: string;
+  swapCid: string;
+};
+/**
+ * Swap history options
+ */
+type SwapHistoryOptions = {
+  cid: string;
+  domain: string;
+};
+/**
+ * Swap CID response
+ */
+type SwapCidResponse = {
+  mapped_cid: string;
+  created_at: string;
+};
+//#endregion
+export { AnalyticsQuery, FileListItem, FileListQuery, FileListResponse, PinJobItem, PinJobQuery, PinJobResponse, PinataConfig, PinataMetadata, SignedUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TimePeriodItem, TopAnalyticsItem, TopAnalyticsQuery, TopAnalyticsResponse, UploadOptions, UploadResponse };
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/adapters/pinata/shared/utils.d.ts

@@ -0,0 +1 @@
+import { CID } from "multiformats/cid";

package/dist/esm/adapters/pinata/shared/utils.js

@@ -0,0 +1,78 @@
+import { CID } from "multiformats/cid";
+
+//#region src/adapters/pinata/shared/utils.ts
+/**
+* Shared utilities for Pinata adapters
+*/
+/**
+* Parse CID string to CID object
+*/
+function parseCID(cidString) {
+	try {
+		return CID.parse(cidString);
+	} catch (error) {
+		throw new Error(`Invalid CID: ${cidString}`);
+	}
+}
+/**
+* Create upload response object
+*/
+function createUploadResponse(result, name) {
+	return {
+		id: result.cid,
+		name: name || "",
+		cid: result.cid,
+		size: result.size,
+		created_at: result.createdAt.toISOString(),
+		number_of_files: 1,
+		mime_type: "application/octet-stream",
+		user_id: "",
+		group_id: null,
+		is_duplicate: null,
+		vectorized: null
+	};
+}
+/**
+* Create file list item from remote pin
+*/
+function createFileListItem(remotePin) {
+	return {
+		id: remotePin.cid.toString(),
+		name: remotePin.name || null,
+		cid: remotePin.cid.toString(),
+		size: remotePin.size || 0,
+		number_of_files: 1,
+		mime_type: "application/octet-stream",
+		keyvalues: remotePin.metadata || {},
+		group_id: null,
+		created_at: remotePin.created.toISOString()
+	};
+}
+/**
+* Create pin job item from remote pin
+*/
+function createPinJobItem(remotePin) {
+	return {
+		id: remotePin.cid.toString(),
+		ipfs_pin_hash: remotePin.cid.toString(),
+		date_queued: remotePin.created.toISOString(),
+		name: remotePin.name || "",
+		status: remotePin.status || "pinned",
+		keyvalues: remotePin.metadata || {},
+		host_nodes: [],
+		pin_policy: {
+			regions: [],
+			version: 1
+		}
+	};
+}
+/**
+* Throw error for unsupported features
+*/
+function notSupported(feature) {
+	throw new Error(`${feature} are not supported by Pinner`);
+}
+
+//#endregion
+export { createFileListItem, createPinJobItem, createUploadResponse, notSupported, parseCID };
+//# sourceMappingURL=utils.js.map

package/dist/esm/adapters/pinata/shared/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../../../../src/adapters/pinata/shared/utils.ts"],"sourcesContent":["/**\n * Shared utilities for Pinata adapters\n */\n\nimport { CID } from \"multiformats/cid\";\n\n/**\n * Parse CID string to CID object\n */\nexport function parseCID(cidString: string): CID {\n\ttry {\n\t\treturn CID.parse(cidString);\n\t} catch (error) {\n\t\tthrow new Error(`Invalid CID: ${cidString}`);\n\t}\n}\n\n/**\n * Convert Date to ISO string\n */\nexport function toISOString(date: Date): string {\n\treturn date.toISOString();\n}\n\n/**\n * Create upload response object\n */\nexport function createUploadResponse(\n\tresult: {\n\t\tcid: string;\n\t\tsize: number;\n\t\tcreatedAt: Date;\n\t},\n\tname?: string,\n): any {\n\treturn {\n\t\tid: result.cid,\n\t\tname: name || \"\",\n\t\tcid: result.cid,\n\t\tsize: result.size,\n\t\tcreated_at: result.createdAt.toISOString(),\n\t\tnumber_of_files: 1,\n\t\tmime_type: \"application/octet-stream\",\n\t\tuser_id: \"\",\n\t\tgroup_id: null,\n\t\tis_duplicate: null,\n\t\tvectorized: null,\n\t};\n}\n\n/**\n * Create file list item from remote pin\n */\nexport function createFileListItem(\n\tremotePin: any,\n): any {\n\treturn {\n\t\tid: remotePin.cid.toString(),\n\t\tname: remotePin.name || null,\n\t\tcid: remotePin.cid.toString(),\n\t\tsize: remotePin.size || 0,\n\t\tnumber_of_files: 1,\n\t\tmime_type: \"application/octet-stream\",\n\t\tkeyvalues: remotePin.metadata || {},\n\t\tgroup_id: null,\n\t\tcreated_at: remotePin.created.toISOString(),\n\t};\n}\n\n/**\n * Create pin job item from remote pin\n */\nexport function createPinJobItem(\n\tremotePin: any,\n): any {\n\treturn {\n\t\tid: remotePin.cid.toString(),\n\t\tipfs_pin_hash: remotePin.cid.toString(),\n\t\tdate_queued: remotePin.created.toISOString(),\n\t\tname: remotePin.name || \"\",\n\t\tstatus: remotePin.status || \"pinned\",\n\t\tkeyvalues: remotePin.metadata || {},\n\t\thost_nodes: [],\n\t\tpin_policy: {\n\t\t\tregions: [],\n\t\t\tversion: 1,\n\t\t},\n\t};\n}\n\n/**\n * Throw error for unsupported features\n */\nexport function notSupported(feature: string): never {\n\tthrow new Error(`${feature} are not supported by Pinner`);\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,SAAS,WAAwB;AAChD,KAAI;AACH,SAAO,IAAI,MAAM,UAAU;UACnB,OAAO;AACf,QAAM,IAAI,MAAM,gBAAgB,YAAY;;;;;;AAc9C,SAAgB,qBACf,QAKA,MACM;AACN,QAAO;EACN,IAAI,OAAO;EACX,MAAM,QAAQ;EACd,KAAK,OAAO;EACZ,MAAM,OAAO;EACb,YAAY,OAAO,UAAU,aAAa;EAC1C,iBAAiB;EACjB,WAAW;EACX,SAAS;EACT,UAAU;EACV,cAAc;EACd,YAAY;EACZ;;;;;AAMF,SAAgB,mBACf,WACM;AACN,QAAO;EACN,IAAI,UAAU,IAAI,UAAU;EAC5B,MAAM,UAAU,QAAQ;EACxB,KAAK,UAAU,IAAI,UAAU;EAC7B,MAAM,UAAU,QAAQ;EACxB,iBAAiB;EACjB,WAAW;EACX,WAAW,UAAU,YAAY,EAAE;EACnC,UAAU;EACV,YAAY,UAAU,QAAQ,aAAa;EAC3C;;;;;AAMF,SAAgB,iBACf,WACM;AACN,QAAO;EACN,IAAI,UAAU,IAAI,UAAU;EAC5B,eAAe,UAAU,IAAI,UAAU;EACvC,aAAa,UAAU,QAAQ,aAAa;EAC5C,MAAM,UAAU,QAAQ;EACxB,QAAQ,UAAU,UAAU;EAC5B,WAAW,UAAU,YAAY,EAAE;EACnC,YAAY,EAAE;EACd,YAAY;GACX,SAAS,EAAE;GACX,SAAS;GACT;EACD;;;;;AAMF,SAAgB,aAAa,SAAwB;AACpD,OAAM,IAAI,MAAM,GAAG,QAAQ,8BAA8B"}