@lumeweb/pinner 0.1.0 → 0.1.3

package/README.md

@@ -7,6 +7,7 @@ A TypeScript library for uploading files to IPFS and managing pinning operations
 - **Multiple Upload Methods**: TUS resumable uploads, XHR uploads, and direct CAR file uploads
 - **Directory Support**: Upload multiple files as a directory to IPFS
 - **Pin Management**: Add, list, remove, and check status of pinned content
+- **Websites & IPNS**: Manage decentralized websites and IPNS name resolution entries
 - **Custom Blockstore**: Flexible storage backend using unstorage (IndexedDB, filesystem, Redis, etc.)
 - **Adapters**: Built-in Pinata adapter with extensible adapter pattern
 - **Encoders**: Support for CSV, JSON, text, base64, and URL encoding
@@ -160,6 +161,157 @@ operation.on("error", (error) => {
 const result = await operation.result;
 ```
 
+## Websites & IPNS APIs
+
+The Pinner client supports managing Websites and IPNS (InterPlanetary Name System) entries for decentralized website hosting and name resolution.
+
+### Websites API
+
+The WebsitesClient provides methods for managing website configurations that link domains to IPFS or IPNS content.
+
+#### List Websites
+
+```typescript
+// List all websites
+const websites = await pinner.websites.listWebsites();
+
+websites.data.forEach(website => {
+  console.log("ID:", website.id);
+  console.log("Domain:", website.domain);
+  console.log("Target Type:", website.target_type); // "ipfs" or "ipns"
+  console.log("Target Hash:", website.target_hash);
+  console.log("Status:", website.status);
+  console.log("Created:", website.created);
+});
+```
+
+#### Get Website by ID
+
+```typescript
+const website = await pinner.websites.getWebsite(websiteId);
+console.log("Website details:", website);
+```
+
+#### Create Website
+
+```typescript
+// Create a new website with IPFS target
+const website = await pinner.websites.createWebsite({
+  domain: "example.com",
+  target_type: "ipfs",
+  target_hash: "Qm..."
+});
+
+// Create a new website with IPNS target
+const website = await pinner.websites.createWebsite({
+  domain: "example.com",
+  target_type: "ipns",
+  target_hash: "k51qzi5uqu5dj14p8d8q8y4e8y4e8y4e8y4e8y4e8y4e8y4e8y4e8y4e8y4e"
+});
+```
+
+#### Update Website
+
+```typescript
+// Update website details (domain, target_type, or target_hash)
+const website = await pinner.websites.updateWebsite(websiteId, {
+  domain: "new-domain.com",
+  target_type: "ipfs",
+  target_hash: "QmNew..."
+});
+```
+
+#### Delete Website
+
+```typescript
+await pinner.websites.deleteWebsite(websiteId);
+```
+
+#### Validate Website DNS
+
+```typescript
+// Trigger DNS TXT record validation for a website domain
+const validation = await pinner.websites.validateWebsite(websiteId);
+console.log("Valid:", validation.valid);
+console.log("Message:", validation.message);
+```
+
+### IPNS API
+
+The IpnsClient provides methods for managing IPNS keys and publishing content to IPNS names.
+
+#### List IPNS Keys
+
+```typescript
+// List all IPNS keys
+const keys = await pinner.ipns.listKeys();
+
+keys.forEach(key => {
+  console.log("ID:", key.id);
+  console.log("Name:", key.name);
+  console.log("IPNS Name:", key.ipns_name);
+  console.log("Peer ID:", key.peer_id);
+  console.log("Created:", key.created);
+});
+```
+
+#### Get IPNS Key by ID
+
+```typescript
+const key = await pinner.ipns.getKey(keyId);
+console.log("IPNS key details:", key);
+```
+
+#### Create IPNS Key
+
+```typescript
+// Create a new IPNS key
+const key = await pinner.ipns.createKey({
+  name: "my-website",
+  key: "optional-key-value"
+});
+```
+
+#### Delete IPNS Key
+
+```typescript
+await pinner.ipns.deleteKey(keyId);
+```
+
+#### Publish to IPNS
+
+```typescript
+// Publish a CID to an IPNS key
+const result = await pinner.ipns.publish({
+  key_id: keyId,
+  cid: "Qm...",
+  ttl: "24h" // optional time-to-live
+});
+
+console.log("Published:", result.name);
+console.log("Value:", result.value);
+console.log("Sequence:", result.sequence);
+```
+
+#### Republish IPNS Records
+
+```typescript
+// Manually trigger IPNS record republishing for all keys
+await pinner.ipns.republish();
+```
+
+#### Resolve IPNS Name
+
+```typescript
+// Resolve an IPNS name to its current CID
+const result = await pinner.ipns.resolve("k51qzi5uqu5dj14p8d8q8y4e8y4e8y4e8y4e8y4e8y4e8y4e8y4e8y4e8y4e8y4e");
+
+console.log("Value:", result.value);
+console.log("Path:", result.path);
+console.log("Sequence:", result.sequence);
+console.log("Expired:", result.expired);
+```
+
 ## Pin Management
 
 ### Pin by CID
@@ -293,22 +445,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 +488,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 +507,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 +518,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 +529,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 +537,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 +546,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 +607,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 +627,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 +653,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();
 ```
@@ -682,6 +851,16 @@ import type {
   RemoteLsOptions
 } from "@lumeweb/pinner";
 
+// Websites & IPNS APIs
+import type {
+  Website,
+  WebsiteCreateRequest,
+  WebsiteUpdateRequest,
+  IPNSEntry,
+  IPNSEntryCreateRequest,
+  IPNSEntryUpdateRequest
+} from "@lumeweb/pinner";
+
 // Blockstore
 import {
   createBlockstore,
@@ -690,7 +869,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/esm/_virtual/{rolldown_runtime.js → _rolldown/runtime.js}

@@ -1,7 +1,7 @@
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
 	if (typeof require !== "undefined") return require.apply(this, arguments);
-	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function.");
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
 });
 
 //#endregion

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

@@ -1,4 +1,4 @@
-import { PinByHashOptions, PinataFile, PinataListBuilder, PinataMetadata, PinataMetadataOptions, PinataPin, PinataUploadBuilder, PinataUploadResult } from "../../types/pinata.js";
-import { PinataAdapter, pinataAdapter } from "./adapter.js";
-import "./builder.js";
-import "./list-builder.js";
+import { PinataAdapter } from "./v2/adapter-interface.js";
+import { pinataAdapter } from "./v2/adapter.js";
+import { AnalyticsQuery, FileListItem, FileListQuery, FileListResponse, PinJobItem, PinJobQuery, PinJobResponse, PinataConfig, PinataMetadata, SignedUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TimePeriodItem, TopAnalyticsItem, TopAnalyticsQuery, TopAnalyticsResponse, UploadOptions, UploadResponse } from "./shared/types.js";
+import { PinataLegacyAdapter, pinataLegacyAdapter } from "./legacy/adapter.js";

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

@@ -1,3 +1,6 @@
-import { PinataAdapterError } from "./builder.js";
-import { createListBuilder } from "./list-builder.js";
-import { pinataAdapter } from "./adapter.js";
+import { createFileListItem, createPinJobItem, createUploadResponse, notSupported, parseCID } from "./shared/utils.js";
+import { pinataAdapter } from "./v2/adapter.js";
+import "./v2/index.js";
+import { pinataLegacyAdapter } from "./legacy/adapter.js";
+import "./legacy/index.js";
+import "./shared/index.js";

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

@@ -0,0 +1,73 @@
+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,124 @@
+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 {
+		/**
+		* Pin a file to IPFS
+		*/
+		async pinFileToIPFS(file, options) {
+			return createUploadResponse(await pinner.uploadAndWait(file, {
+				name: options?.metadata?.name,
+				keyvalues: options?.metadata?.keyvalues
+			}), file.name);
+		},
+		/**
+		* Pin JSON data to IPFS
+		*/
+		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);
+		},
+		/**
+		* Pin content by CID
+		*/
+		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 || "");
+		},
+		/**
+		* List pinned files
+		*/
+		async pinList(query) {
+			return {
+				files: (await pinner.listPins({ limit: query?.limit })).map(createFileListItem),
+				next_page_token: ""
+			};
+		},
+		/**
+		* Unpin content
+		*/
+		async unpin(cid) {
+			await pinner.unpin(cid);
+			return { message: `Unpinned ${cid}` };
+		},
+		/**
+		* Update pin metadata
+		*/
+		async hashMetadata(cid, metadata) {
+			await pinner.setPinMetadata(cid, metadata);
+			return { message: `Updated metadata for ${cid}` };
+		},
+		/**
+		* Create signed URL (not fully supported in Pinner)
+		* Returns a gateway URL instead
+		*/
+		async createSignedURL(options) {
+			return `${config?.pinataGateway || "https://dweb.link"}/ipfs/${options.cid}`;
+		},
+		/**
+		* Get pin jobs
+		*/
+		async pinJobs(query) {
+			return { rows: (await pinner.listPins({ limit: query?.limit })).map(createPinJobItem) };
+		},
+		/**
+		* Get top usage analytics (not supported in Pinner)
+		* Returns empty data
+		*/
+		async topUsageAnalytics(query) {
+			return { data: [] };
+		},
+		/**
+		* Get date interval analytics (not supported in Pinner)
+		* Returns empty data
+		*/
+		async dateIntervalAnalytics(query) {
+			return {
+				total_requests: 0,
+				total_bandwidth: 0,
+				time_periods: []
+			};
+		},
+		/**
+		* Swap CID (not supported in Pinner)
+		* Returns error
+		*/
+		async swapCid(options) {
+			notSupported("Swap CID");
+		},
+		/**
+		* Get swap history (not supported in Pinner)
+		* Returns empty array
+		*/
+		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,qBAAqB,MALP,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,qBAAqB,MALP,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,QAAO,MALW,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,qCACN,QAAQ,QAAQ;;;;;EAMnC,MAAM,QAAQ,OAA8C;AAK3D,UAAO,EACN,OAAM,MALY,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 @@
+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";

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

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