@lumeweb/pinner 0.1.0 → 0.1.1

package/README.md

@@ -293,22 +293,39 @@ See [blockstore/README.md](./src/blockstore/README.md) for detailed blockstore d
 
 ## Adapters
 
-### Pinata Adapter
+### Pinata Adapters
 
-The Pinata adapter provides a Pinata SDK-compatible interface for the Pinner client, making it easy to migrate from Pinata SDK with minimal code changes.
+The Pinata adapters provide Pinata SDK API compatibility for the Pinner client, allowing applications written for the Pinata SDK to work with Lume's IPFS pinning infrastructure with minimal code changes.
+
+**Attribution**: These adapters include TypeScript type definitions and API interfaces adapted from the Pinata SDK for compatibility purposes. The original Pinata SDK is available at:
+- **Pinata SDK 2.x**: https://github.com/PinataCloud/pinata/commit/cdc0c06116aaadaf7c4b287a2673cd23b6ba1125
+- **Pinata SDK 1.x**: https://github.com/PinataCloud/pinata/commit/c141177ff3036e46fa7b95fcc68c159b58817836
+
+The adapters provide Pinata SDK API compatibility but route all operations through Lume's IPFS pinning infrastructure. They do NOT use Pinata's servers or services.
+
+#### Available Adapters
+
+- **V2 Adapter** (`pinataAdapter`): Compatible with Pinata SDK 2.x API (recommended, latest)
+- **Legacy Adapter** (`pinataLegacyAdapter`): Compatible with Pinata SDK 1.x API
+
+See [adapters/README.md](./src/adapters/README.md) for comprehensive documentation including migration guides, feature support tables, and detailed examples.
 
 #### Setup
 
 ```typescript
-import { Pinner, pinataAdapter } from "@lumeweb/pinner";
+import { Pinner, pinataAdapter, pinataLegacyAdapter } from "@lumeweb/pinner";
 
 // Initialize Pinner
 const pinner = new Pinner({
-  jwt: "your-jwt-token"
+  jwt: "your-jwt-token",
+  endpoint: "https://your-pinning-service-endpoint.com"
 });
 
-// Create Pinata adapter
+// Create Pinata V2 adapter (recommended)
 const pinata = pinataAdapter(pinner);
+
+// Or use the legacy adapter
+const pinataLegacy = pinataLegacyAdapter(pinner);
 ```
 
 #### Upload Methods
@@ -319,12 +336,12 @@ The Pinata adapter provides multiple upload methods with a fluent builder patter
 
 ```typescript
 // Simple file upload
-const result = await pinata.upload.file(file).execute();
+const result = await pinata.upload.public.file(file).execute();
 console.log("CID:", result.IpfsHash);
 console.log("Size:", result.PinSize);
 
 // Upload with metadata
-const result = await pinata.upload.file(file)
+const result = await pinata.upload.public.file(file)
   .name("My File")
   .keyvalues({ key: "value" })
   .execute();
@@ -338,7 +355,7 @@ const files = [
   new File(["content2"], "file2.txt")
 ];
 
-const result = await pinata.upload.fileArray(files)
+const result = await pinata.upload.public.fileArray(files)
   .name("My Directory")
   .keyvalues({ type: "directory" })
   .execute();
@@ -349,7 +366,7 @@ const result = await pinata.upload.fileArray(files)
 ```typescript
 const data = { foo: "bar", number: 42 };
 
-const result = await pinata.upload.json(data)
+const result = await pinata.upload.public.json(data)
   .name("data.json")
   .keyvalues({ format: "json" })
   .execute();
@@ -360,7 +377,7 @@ const result = await pinata.upload.json(data)
 ```typescript
 const base64String = "SGVsbG8sIHdvcmxkIQ==";
 
-const result = await pinata.upload.base64(base64String)
+const result = await pinata.upload.public.base64(base64String)
   .name("base64-file.txt")
   .execute();
 ```
@@ -368,7 +385,7 @@ const result = await pinata.upload.base64(base64String)
 ##### Upload from URL
 
 ```typescript
-const result = await pinata.upload.url("https://example.com/data.json")
+const result = await pinata.upload.public.url("https://example.com/data.json")
   .name("downloaded-file.json")
   .execute();
 ```
@@ -377,10 +394,10 @@ const result = await pinata.upload.url("https://example.com/data.json")
 
 ```typescript
 // Pin existing content
-await pinata.upload.cid("Qm...").execute();
+await pinata.upload.public.cid("Qm...").execute();
 
 // Pin with metadata
-await pinata.upload.cid("Qm...")
+await pinata.upload.public.cid("Qm...")
   .name("Existing Content")
   .keyvalues({ source: "external" })
   .execute();
@@ -438,10 +455,10 @@ await pinata.setPinMetadata("Qm...", {
 
 ```typescript
 // List all files
-const files = await pinata.files.list().execute();
+const files = await pinata.files.public.list().execute();
 
 // List with pagination
-const files = await pinata.files.list()
+const files = await pinata.files.public.list()
   .limit(10)
   .pageToken("next-page-token")
   .execute();
@@ -458,7 +475,7 @@ files.forEach(file => {
 ##### Get File by ID
 
 ```typescript
-const file = await pinata.files.get("Qm...");
+const file = await pinata.files.public.get("Qm...");
 console.log("File details:", file);
 ```
 
@@ -484,7 +501,7 @@ import { Pinner, pinataAdapter } from '@lumeweb/pinner';
 const pinner = new Pinner({ jwt: 'your-jwt-token' });
 const pinata = pinataAdapter(pinner);
 
-const result = await pinata.upload.file(file)
+const result = await pinata.upload.public.file(file)
   .name('My File')
   .execute();
 ```
@@ -690,7 +707,7 @@ import {
 } from "@lumeweb/pinner";
 
 // Adapters
-import { pinataAdapter } from "@lumeweb/pinner/adapters/pinata";
+import { pinataAdapter, pinataLegacyAdapter } from "@lumeweb/pinner";
 
 // Blockstore module
 import { UnstorageBlockstore } from "@lumeweb/pinner/blockstore";

package/dist/cjs/adapters/pinata/index.cjs

@@ -1,3 +1,6 @@
-const require_builder = require('./builder.cjs');
-const require_list_builder = require('./list-builder.cjs');
-const require_adapter = require('./adapter.cjs');
+const require_utils = require('./shared/utils.cjs');
+const require_adapter = require('./v2/adapter.cjs');
+require('./v2/index.cjs');
+const require_adapter$1 = require('./legacy/adapter.cjs');
+require('./legacy/index.cjs');
+require('./shared/index.cjs');

package/dist/cjs/adapters/pinata/legacy/adapter.cjs

@@ -0,0 +1,83 @@
+const require_constants = require('../../../types/constants.cjs');
+const require_utils = require('../shared/utils.cjs');
+
+//#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 require_utils.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 require_utils.createUploadResponse(await pinner.uploadAndWait(file, {
+				name: options?.metadata?.name,
+				keyvalues: options?.metadata?.keyvalues
+			}), file.name);
+		},
+		async pinByHash(cid, options) {
+			const cidObj = require_utils.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 require_utils.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(require_utils.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 || require_constants.DEFAULT_GATEWAY}/ipfs/${options.cid}`;
+		},
+		async pinJobs(query) {
+			return { rows: (await pinner.listPins({ limit: query?.limit })).map(require_utils.createPinJobItem) };
+		},
+		async topUsageAnalytics(query) {
+			return { data: [] };
+		},
+		async dateIntervalAnalytics(query) {
+			return {
+				total_requests: 0,
+				total_bandwidth: 0,
+				time_periods: []
+			};
+		},
+		async swapCid(options) {
+			require_utils.notSupported("Swap CID");
+		},
+		async swapHistory(options) {
+			return [];
+		}
+	};
+}
+
+//#endregion
+exports.pinataLegacyAdapter = pinataLegacyAdapter;
+//# sourceMappingURL=adapter.cjs.map

package/dist/cjs/adapters/pinata/legacy/adapter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.cjs","names":["createUploadResponse","parseCID","createFileListItem","DEFAULT_GATEWAY","createPinJobItem"],"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,UAAOA,mCALQ,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,UAAOA,mCALQ,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,SAASC,uBAAS,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,UAAOD,mCACN;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,IAAIE,iCAAmB;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,iBAAiBC,kCACvB,QAAQ,QAAQ;;EAMnC,MAAM,QAAQ,OAA8C;AAK3D,UAAO,EACN,OALY,MAAM,OAAO,SAAS,EAClC,OAAO,OAAO,OACd,CAAC,EAGU,IAAIC,+BAAiB,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,8BAAa,WAAW;;EAOzB,MAAM,YAAY,SAAyD;AAE1E,UAAO,EAAE;;EAEV"}

package/dist/cjs/adapters/pinata/legacy/adapter.d.cts

@@ -0,0 +1,74 @@
+import { Pinner } from "../../../pinner.cjs";
+import { FileListQuery, FileListResponse, PinJobQuery, PinJobResponse, PinataConfig, SignedUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TopAnalyticsQuery, TopAnalyticsResponse, UploadOptions, UploadResponse } from "../shared/types.cjs";
+
+//#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.cts.map

package/dist/cjs/adapters/pinata/legacy/index.cjs

@@ -0,0 +1 @@
+const require_adapter = require('./adapter.cjs');

package/dist/cjs/adapters/pinata/shared/index.cjs

@@ -0,0 +1 @@
+const require_utils = require('./utils.cjs');

package/dist/cjs/adapters/pinata/shared/types.d.cts

@@ -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 { FileListQuery, FileListResponse, PinJobQuery, PinJobResponse, PinataConfig, SignedUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TopAnalyticsQuery, TopAnalyticsResponse, UploadOptions, UploadResponse };
+//# sourceMappingURL=types.d.cts.map

package/dist/cjs/adapters/pinata/shared/utils.cjs

@@ -0,0 +1,83 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let multiformats_cid = require("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 multiformats_cid.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
+exports.createFileListItem = createFileListItem;
+exports.createPinJobItem = createPinJobItem;
+exports.createUploadResponse = createUploadResponse;
+exports.notSupported = notSupported;
+exports.parseCID = parseCID;
+//# sourceMappingURL=utils.cjs.map

package/dist/cjs/adapters/pinata/shared/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":["CID"],"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,SAAOA,qBAAI,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"}