@lumeweb/pinner 0.0.1 → 0.1.0

package/dist/cjs/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,29 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

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

@@ -0,0 +1,88 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_builder = require('./builder.cjs');
+const require_list_builder = require('./list-builder.cjs');
+let multiformats_cid = require("multiformats/cid");
+
+//#region src/adapters/pinata/adapter.ts
+/**
+* Creates a Pinata-compatible adapter for the Pinner client.
+*/
+function pinataAdapter(pinner) {
+	return {
+		upload: {
+			file(file) {
+				return require_builder.createUploadBuilder(pinner, file);
+			},
+			fileArray(files) {
+				return require_builder.createFileArrayUploadBuilder(pinner, files);
+			},
+			json(data) {
+				return require_builder.createJsonUploadBuilder(pinner, data);
+			},
+			base64(base64String) {
+				return require_builder.createBase64UploadBuilder(pinner, base64String);
+			},
+			url(urlString) {
+				return require_builder.createUrlUploadBuilder(pinner, urlString);
+			},
+			cid(cidString) {
+				return require_builder.createCidUploadBuilder(pinner, cidString);
+			}
+		},
+		async pinByHash(cid, options) {
+			const cidObj = multiformats_cid.CID.parse(cid);
+			const generator = await pinner.pinByHash(cidObj, {
+				name: options?.name,
+				metadata: options?.keyvalues
+			});
+			for await (const _ of generator);
+		},
+		async unpin(cid) {
+			await pinner.unpin(cid);
+		},
+		async getPinStatus(cid) {
+			const cidObj = multiformats_cid.CID.parse(cid);
+			const remotePin = await pinner.getPinStatus(cidObj);
+			return {
+				id: cidObj.toString(),
+				ipfsPinHash: cidObj.toString(),
+				size: remotePin.size || 0,
+				userId: "",
+				datePinned: remotePin.created.toISOString(),
+				metadata: {
+					name: remotePin.name,
+					keyvalues: remotePin.metadata
+				}
+			};
+		},
+		async isPinned(cid) {
+			const cidObj = multiformats_cid.CID.parse(cid);
+			return pinner.isPinned(cidObj);
+		},
+		async setPinMetadata(cid, metadata) {
+			const cidObj = multiformats_cid.CID.parse(cid);
+			await pinner.setPinMetadata(cidObj, metadata);
+		},
+		files: {
+			list() {
+				return require_list_builder.createListBuilder(pinner);
+			},
+			async get(id) {
+				const pin = (await pinner.listPins()).find((p) => p.cid.toString() === id);
+				if (!pin) throw new Error(`Pin not found: ${id}`);
+				return {
+					id: pin.cid.toString(),
+					ipfsPinHash: pin.cid.toString(),
+					size: pin.size || 0,
+					name: pin.name || "",
+					cid: pin.cid.toString(),
+					createdAt: pin.created.toISOString()
+				};
+			}
+		}
+	};
+}
+
+//#endregion
+exports.pinataAdapter = pinataAdapter;
+//# sourceMappingURL=adapter.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.cjs","names":["createUploadBuilder","createFileArrayUploadBuilder","createJsonUploadBuilder","createBase64UploadBuilder","createUrlUploadBuilder","createCidUploadBuilder","CID","createListBuilder"],"sources":["../../../../src/adapters/pinata/adapter.ts"],"sourcesContent":["import type { Pinner } from \"@/pinner\";\nimport {\n  createBase64UploadBuilder,\n  createCidUploadBuilder,\n  createFileArrayUploadBuilder,\n  createJsonUploadBuilder,\n  createUploadBuilder,\n  createUrlUploadBuilder,\n} from \"./builder\";\nimport { createListBuilder } from \"./list-builder\";\nimport type {\n  PinataFile,\n  PinataListBuilder,\n  PinataPin,\n  PinataUploadBuilder,\n  PinataUploadResult,\n  PinByHashOptions,\n} from \"@/types/pinata\";\nimport { CID } from \"multiformats/cid\";\n\n/**\n * Creates a Pinata-compatible adapter for the Pinner client.\n * This allows users to migrate from Pinata SDK with minimal code changes.\n */\nexport interface PinataAdapter {\n  upload: {\n    file(file: File): PinataUploadBuilder<PinataUploadResult>;\n    fileArray(files: File[]): PinataUploadBuilder<PinataUploadResult>;\n    json(data: object): PinataUploadBuilder<PinataUploadResult>;\n    base64(base64String: string): PinataUploadBuilder<PinataUploadResult>;\n    url(urlString: string): PinataUploadBuilder<PinataUploadResult>;\n    cid(cidString: string): PinataUploadBuilder<void>;\n  };\n\n  pinByHash(cid: string, options?: PinByHashOptions): Promise<void>;\n  unpin(cid: string): Promise<void>;\n  getPinStatus(cid: string): Promise<PinataPin>;\n  isPinned(cid: string): Promise<boolean>;\n  setPinMetadata(cid: string, metadata: Record<string, string>): Promise<void>;\n\n  files: {\n    list(): PinataListBuilder<PinataFile[]>;\n    get(id: string): Promise<PinataFile>;\n  };\n}\n\n/**\n * Creates a Pinata-compatible adapter for the Pinner client.\n */\nexport function pinataAdapter(pinner: Pinner): PinataAdapter {\n  return {\n    upload: {\n      file(file: File): PinataUploadBuilder<PinataUploadResult> {\n        return createUploadBuilder(pinner, file);\n      },\n      fileArray(files: File[]): PinataUploadBuilder<PinataUploadResult> {\n        return createFileArrayUploadBuilder(pinner, files);\n      },\n      json(data: object): PinataUploadBuilder<PinataUploadResult> {\n        return createJsonUploadBuilder(pinner, data);\n      },\n      base64(base64String: string): PinataUploadBuilder<PinataUploadResult> {\n        return createBase64UploadBuilder(pinner, base64String);\n      },\n      url(urlString: string): PinataUploadBuilder<PinataUploadResult> {\n        return createUrlUploadBuilder(pinner, urlString);\n      },\n      cid(cidString: string): PinataUploadBuilder<void> {\n        return createCidUploadBuilder(pinner, cidString);\n      },\n    },\n\n    async pinByHash(cid: string, options?: PinByHashOptions): Promise<void> {\n      const cidObj = CID.parse(cid);\n      const generatorPromise = pinner.pinByHash(cidObj, {\n        name: options?.name,\n        metadata: options?.keyvalues,\n      });\n\n      const generator = await generatorPromise;\n      for await (const _ of generator) {\n        // Pin operation in progress\n      }\n    },\n\n    async unpin(cid: string): Promise<void> {\n      await pinner.unpin(cid);\n    },\n\n    async getPinStatus(cid: string): Promise<PinataPin> {\n      const cidObj = CID.parse(cid);\n      const remotePin = await pinner.getPinStatus(cidObj);\n\n      return {\n        id: cidObj.toString(),\n        ipfsPinHash: cidObj.toString(),\n        size: remotePin.size || 0,\n        userId: \"\",\n        datePinned: remotePin.created.toISOString(),\n        metadata: {\n          name: remotePin.name,\n          keyvalues: remotePin.metadata,\n        },\n      };\n    },\n\n    async isPinned(cid: string): Promise<boolean> {\n      const cidObj = CID.parse(cid);\n      return pinner.isPinned(cidObj);\n    },\n\n    async setPinMetadata(\n      cid: string,\n      metadata: Record<string, string>,\n    ): Promise<void> {\n      const cidObj = CID.parse(cid);\n      await pinner.setPinMetadata(cidObj, metadata);\n    },\n\n    files: {\n      list(): PinataListBuilder<PinataFile[]> {\n        return createListBuilder(pinner);\n      },\n      async get(id: string): Promise<PinataFile> {\n        const pins = await pinner.listPins();\n        const pin = pins.find((p) => p.cid.toString() === id);\n\n        if (!pin) {\n          throw new Error(`Pin not found: ${id}`);\n        }\n\n        return {\n          id: pin.cid.toString(),\n          ipfsPinHash: pin.cid.toString(),\n          size: pin.size || 0,\n          name: pin.name || \"\",\n          cid: pin.cid.toString(),\n          createdAt: pin.created.toISOString(),\n        };\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAiDA,SAAgB,cAAc,QAA+B;AAC3D,QAAO;EACL,QAAQ;GACN,KAAK,MAAqD;AACxD,WAAOA,oCAAoB,QAAQ,KAAK;;GAE1C,UAAU,OAAwD;AAChE,WAAOC,6CAA6B,QAAQ,MAAM;;GAEpD,KAAK,MAAuD;AAC1D,WAAOC,wCAAwB,QAAQ,KAAK;;GAE9C,OAAO,cAA+D;AACpE,WAAOC,0CAA0B,QAAQ,aAAa;;GAExD,IAAI,WAA4D;AAC9D,WAAOC,uCAAuB,QAAQ,UAAU;;GAElD,IAAI,WAA8C;AAChD,WAAOC,uCAAuB,QAAQ,UAAU;;GAEnD;EAED,MAAM,UAAU,KAAa,SAA2C;GACtE,MAAM,SAASC,qBAAI,MAAM,IAAI;GAM7B,MAAM,YAAY,MALO,OAAO,UAAU,QAAQ;IAChD,MAAM,SAAS;IACf,UAAU,SAAS;IACpB,CAAC;AAGF,cAAW,MAAM,KAAK;;EAKxB,MAAM,MAAM,KAA4B;AACtC,SAAM,OAAO,MAAM,IAAI;;EAGzB,MAAM,aAAa,KAAiC;GAClD,MAAM,SAASA,qBAAI,MAAM,IAAI;GAC7B,MAAM,YAAY,MAAM,OAAO,aAAa,OAAO;AAEnD,UAAO;IACL,IAAI,OAAO,UAAU;IACrB,aAAa,OAAO,UAAU;IAC9B,MAAM,UAAU,QAAQ;IACxB,QAAQ;IACR,YAAY,UAAU,QAAQ,aAAa;IAC3C,UAAU;KACR,MAAM,UAAU;KAChB,WAAW,UAAU;KACtB;IACF;;EAGH,MAAM,SAAS,KAA+B;GAC5C,MAAM,SAASA,qBAAI,MAAM,IAAI;AAC7B,UAAO,OAAO,SAAS,OAAO;;EAGhC,MAAM,eACJ,KACA,UACe;GACf,MAAM,SAASA,qBAAI,MAAM,IAAI;AAC7B,SAAM,OAAO,eAAe,QAAQ,SAAS;;EAG/C,OAAO;GACL,OAAwC;AACtC,WAAOC,uCAAkB,OAAO;;GAElC,MAAM,IAAI,IAAiC;IAEzC,MAAM,OADO,MAAM,OAAO,UAAU,EACnB,MAAM,MAAM,EAAE,IAAI,UAAU,KAAK,GAAG;AAErD,QAAI,CAAC,IACH,OAAM,IAAI,MAAM,kBAAkB,KAAK;AAGzC,WAAO;KACL,IAAI,IAAI,IAAI,UAAU;KACtB,aAAa,IAAI,IAAI,UAAU;KAC/B,MAAM,IAAI,QAAQ;KAClB,MAAM,IAAI,QAAQ;KAClB,KAAK,IAAI,IAAI,UAAU;KACvB,WAAW,IAAI,QAAQ,aAAa;KACrC;;GAEJ;EACF"}

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

@@ -0,0 +1,35 @@
+import { Pinner } from "../../pinner.cjs";
+import { PinByHashOptions, PinataFile, PinataListBuilder, PinataPin, PinataUploadBuilder, PinataUploadResult } from "../../types/pinata.cjs";
+
+//#region src/adapters/pinata/adapter.d.ts
+
+/**
+ * Creates a Pinata-compatible adapter for the Pinner client.
+ * This allows users to migrate from Pinata SDK with minimal code changes.
+ */
+interface PinataAdapter {
+  upload: {
+    file(file: File): PinataUploadBuilder<PinataUploadResult>;
+    fileArray(files: File[]): PinataUploadBuilder<PinataUploadResult>;
+    json(data: object): PinataUploadBuilder<PinataUploadResult>;
+    base64(base64String: string): PinataUploadBuilder<PinataUploadResult>;
+    url(urlString: string): PinataUploadBuilder<PinataUploadResult>;
+    cid(cidString: string): PinataUploadBuilder<void>;
+  };
+  pinByHash(cid: string, options?: PinByHashOptions): Promise<void>;
+  unpin(cid: string): Promise<void>;
+  getPinStatus(cid: string): Promise<PinataPin>;
+  isPinned(cid: string): Promise<boolean>;
+  setPinMetadata(cid: string, metadata: Record<string, string>): Promise<void>;
+  files: {
+    list(): PinataListBuilder<PinataFile[]>;
+    get(id: string): Promise<PinataFile>;
+  };
+}
+/**
+ * Creates a Pinata-compatible adapter for the Pinner client.
+ */
+declare function pinataAdapter(pinner: Pinner): PinataAdapter;
+//#endregion
+export { pinataAdapter };
+//# sourceMappingURL=adapter.d.cts.map

package/dist/cjs/adapters/pinata/builder.cjs

@@ -0,0 +1,194 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_json = require('../../encoder/json.cjs');
+const require_base64 = require('../../encoder/base64.cjs');
+const require_url = require('../../encoder/url.cjs');
+require('../../encoder/index.cjs');
+const require_validation = require('../../utils/validation.cjs');
+let multiformats_cid = require("multiformats/cid");
+
+//#region src/adapters/pinata/builder.ts
+/**
+* Error wrapper for Pinata adapter operations.
+*/
+var PinataAdapterError = class extends Error {
+	code;
+	cause;
+	constructor(message, code, cause) {
+		super(message);
+		this.name = "PinataAdapterError";
+		this.code = code;
+		this.cause = cause;
+	}
+};
+/**
+* Base upload builder with common name/keyvalues functionality.
+*/
+var BaseUploadBuilder = class {
+	_name;
+	_keyvalues;
+	constructor(pinner) {
+		this.pinner = pinner;
+	}
+	name(name) {
+		this._name = name;
+		return this;
+	}
+	keyvalues(kv) {
+		this._keyvalues = kv;
+		return this;
+	}
+	toUploadResult(result) {
+		return {
+			IpfsHash: result.cid,
+			PinSize: result.size,
+			Timestamp: result.createdAt.toISOString(),
+			isDuplicate: false
+		};
+	}
+};
+/**
+* File upload builder.
+*/
+var FileUploadBuilder = class extends BaseUploadBuilder {
+	constructor(pinner, file) {
+		super(pinner);
+		this.file = file;
+	}
+	async execute() {
+		const result = await this.pinner.uploadAndWait(this.file, {
+			name: this._name,
+			keyvalues: this._keyvalues
+		});
+		return this.toUploadResult(result);
+	}
+};
+/**
+* File array upload builder.
+*/
+var FileArrayUploadBuilder = class extends BaseUploadBuilder {
+	constructor(pinner, files) {
+		super(pinner);
+		this.files = files;
+		if (files.length === 0) throw new PinataAdapterError("Cannot upload empty file array", "EMPTY_FILE_ARRAY");
+	}
+	async execute() {
+		try {
+			const result = await (await this.pinner.uploadDirectory(this.files, {
+				name: this._name,
+				keyvalues: this._keyvalues
+			})).result;
+			return this.toUploadResult(result);
+		} catch (error) {
+			if (error instanceof Error) throw new PinataAdapterError(`File array upload failed: ${error.message}`, "UPLOAD_FAILED", error);
+			throw error;
+		}
+	}
+};
+/**
+* Encoded upload builder - handles JSON, Base64, and URL uploads using encoders.
+*/
+var EncodedUploadBuilder = class extends BaseUploadBuilder {
+	constructor(pinner, encoderFn) {
+		super(pinner);
+		this.encoderFn = encoderFn;
+	}
+	async execute() {
+		try {
+			const encoded = await this.encoderFn(this._name, this._keyvalues);
+			const result = await this.pinner.uploadAndWait(encoded.file, encoded.options);
+			return this.toUploadResult(result);
+		} catch (error) {
+			if (error instanceof Error) throw new PinataAdapterError(`Upload failed: ${error.message}`, "UPLOAD_FAILED", error);
+			throw error;
+		}
+	}
+};
+/**
+* CID upload builder (pin by CID).
+*/
+var CidUploadBuilder = class {
+	_name;
+	_keyvalues;
+	constructor(pinner, cidString) {
+		this.pinner = pinner;
+		this.cidString = cidString;
+	}
+	name(name) {
+		this._name = name;
+		return this;
+	}
+	keyvalues(kv) {
+		this._keyvalues = kv;
+		return this;
+	}
+	async execute() {
+		try {
+			const cid = multiformats_cid.CID.parse(this.cidString);
+			const generator = await this.pinner.pinByHash(cid, {
+				name: this._name,
+				metadata: this._keyvalues
+			});
+			for await (const _ of generator);
+		} catch (error) {
+			if (error instanceof Error) throw new PinataAdapterError(`CID upload failed: ${error.message}`, "INVALID_CID", error);
+			throw error;
+		}
+	}
+};
+/**
+* Create a file upload builder.
+*/
+function createUploadBuilder(pinner, file) {
+	return new FileUploadBuilder(pinner, file);
+}
+/**
+* Create a file array upload builder.
+*/
+function createFileArrayUploadBuilder(pinner, files) {
+	return new FileArrayUploadBuilder(pinner, files);
+}
+/**
+* Create a JSON upload builder.
+*/
+function createJsonUploadBuilder(pinner, data) {
+	return new EncodedUploadBuilder(pinner, (name, keyvalues) => require_json.jsonToFile(data, {
+		name,
+		keyvalues
+	}));
+}
+/**
+* Create a base64 upload builder.
+*/
+function createBase64UploadBuilder(pinner, base64String) {
+	return new EncodedUploadBuilder(pinner, (name, keyvalues) => require_base64.base64ToFile(base64String, {
+		name,
+		keyvalues
+	}));
+}
+/**
+* Create a URL upload builder.
+*/
+function createUrlUploadBuilder(pinner, urlString, options) {
+	require_validation.validateUrl(urlString);
+	return new EncodedUploadBuilder(pinner, (name, keyvalues) => require_url.urlToFile(urlString, {
+		name,
+		keyvalues,
+		fetch: options?.fetch
+	}));
+}
+/**
+* Create a CID upload builder.
+*/
+function createCidUploadBuilder(pinner, cidString) {
+	return new CidUploadBuilder(pinner, cidString);
+}
+
+//#endregion
+exports.PinataAdapterError = PinataAdapterError;
+exports.createBase64UploadBuilder = createBase64UploadBuilder;
+exports.createCidUploadBuilder = createCidUploadBuilder;
+exports.createFileArrayUploadBuilder = createFileArrayUploadBuilder;
+exports.createJsonUploadBuilder = createJsonUploadBuilder;
+exports.createUploadBuilder = createUploadBuilder;
+exports.createUrlUploadBuilder = createUrlUploadBuilder;
+//# sourceMappingURL=builder.cjs.map

package/dist/cjs/adapters/pinata/builder.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.cjs","names":["CID","jsonToFile","base64ToFile","urlToFile"],"sources":["../../../../src/adapters/pinata/builder.ts"],"sourcesContent":["import type { Pinner } from \"@/pinner\";\nimport type {\n  PinataUploadBuilder,\n  PinataUploadResult,\n  UrlUploadBuilderOptions,\n} from \"@/types/pinata\";\nimport type { UploadOptions } from \"@/encoder/types\";\nimport { CID } from \"multiformats/cid\";\nimport { base64ToFile, jsonToFile, urlToFile } from \"@/encoder\";\nimport { validateUrl } from \"@/utils/validation\";\n\n/**\n * Error wrapper for Pinata adapter operations.\n */\nexport class PinataAdapterError extends Error {\n  code: \"UPLOAD_FAILED\" | \"EMPTY_FILE_ARRAY\" | \"INVALID_CID\";\n  cause?: Error;\n\n  constructor(\n    message: string,\n    code: PinataAdapterError[\"code\"],\n    cause?: Error,\n  ) {\n    super(message);\n    this.name = \"PinataAdapterError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\n/**\n * Base upload builder with common name/keyvalues functionality.\n */\nabstract class BaseUploadBuilder<\n  TResult,\n> implements PinataUploadBuilder<TResult> {\n  protected _name?: string;\n  protected _keyvalues?: Record<string, string>;\n\n  constructor(protected pinner: Pinner) {}\n\n  name(name: string): this {\n    this._name = name;\n    return this;\n  }\n\n  keyvalues(kv: Record<string, string>): this {\n    this._keyvalues = kv;\n    return this;\n  }\n\n  abstract execute(): Promise<TResult>;\n\n  protected toUploadResult(result: {\n    cid: string;\n    size: number;\n    createdAt: Date;\n  }): PinataUploadResult {\n    return {\n      IpfsHash: result.cid,\n      PinSize: result.size,\n      Timestamp: result.createdAt.toISOString(),\n      isDuplicate: false,\n    };\n  }\n}\n\n/**\n * File upload builder.\n */\nclass FileUploadBuilder extends BaseUploadBuilder<PinataUploadResult> {\n  constructor(\n    pinner: Pinner,\n    private file: File,\n  ) {\n    super(pinner);\n  }\n\n  async execute(): Promise<PinataUploadResult> {\n    const result = await this.pinner.uploadAndWait(this.file, {\n      name: this._name,\n      keyvalues: this._keyvalues,\n    });\n    return this.toUploadResult(result);\n  }\n}\n\n/**\n * File array upload builder.\n */\nclass FileArrayUploadBuilder extends BaseUploadBuilder<PinataUploadResult> {\n  constructor(\n    pinner: Pinner,\n    private files: File[],\n  ) {\n    super(pinner);\n    if (files.length === 0) {\n      throw new PinataAdapterError(\n        \"Cannot upload empty file array\",\n        \"EMPTY_FILE_ARRAY\",\n      );\n    }\n  }\n\n  async execute(): Promise<PinataUploadResult> {\n    try {\n      const operation = await this.pinner.uploadDirectory(this.files, {\n        name: this._name,\n        keyvalues: this._keyvalues,\n      });\n      const result = await operation.result;\n      return this.toUploadResult(result);\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new PinataAdapterError(\n          `File array upload failed: ${error.message}`,\n          \"UPLOAD_FAILED\",\n          error,\n        );\n      }\n      throw error;\n    }\n  }\n}\n\n/**\n * Encoded upload builder - handles JSON, Base64, and URL uploads using encoders.\n */\nclass EncodedUploadBuilder extends BaseUploadBuilder<PinataUploadResult> {\n  constructor(\n    pinner: Pinner,\n    private encoderFn: (\n      name?: string,\n      keyvalues?: Record<string, string>,\n    ) => Promise<{ file: File; options: UploadOptions }>,\n  ) {\n    super(pinner);\n  }\n\n  async execute(): Promise<PinataUploadResult> {\n    try {\n      const encoded = await this.encoderFn(this._name, this._keyvalues);\n      const result = await this.pinner.uploadAndWait(\n        encoded.file,\n        encoded.options,\n      );\n      return this.toUploadResult(result);\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new PinataAdapterError(\n          `Upload failed: ${error.message}`,\n          \"UPLOAD_FAILED\",\n          error,\n        );\n      }\n      throw error;\n    }\n  }\n}\n\n/**\n * CID upload builder (pin by CID).\n */\nclass CidUploadBuilder implements PinataUploadBuilder<void> {\n  private _name?: string;\n  private _keyvalues?: Record<string, string>;\n\n  constructor(\n    private pinner: Pinner,\n    private cidString: string,\n  ) {}\n\n  name(name: string): this {\n    this._name = name;\n    return this;\n  }\n\n  keyvalues(kv: Record<string, string>): this {\n    this._keyvalues = kv;\n    return this;\n  }\n\n  async execute(): Promise<void> {\n    try {\n      const cid = CID.parse(this.cidString);\n      const generator = await this.pinner.pinByHash(cid, {\n        name: this._name,\n        metadata: this._keyvalues,\n      });\n      for await (const _ of generator) {\n        // Pin operation in progress\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new PinataAdapterError(\n          `CID upload failed: ${error.message}`,\n          \"INVALID_CID\",\n          error,\n        );\n      }\n      throw error;\n    }\n  }\n}\n\n/**\n * Create a file upload builder.\n */\nexport function createUploadBuilder(\n  pinner: Pinner,\n  file: File,\n): PinataUploadBuilder<PinataUploadResult> {\n  return new FileUploadBuilder(pinner, file);\n}\n\n/**\n * Create a file array upload builder.\n */\nexport function createFileArrayUploadBuilder(\n  pinner: Pinner,\n  files: File[],\n): PinataUploadBuilder<PinataUploadResult> {\n  return new FileArrayUploadBuilder(pinner, files);\n}\n\n/**\n * Create a JSON upload builder.\n */\nexport function createJsonUploadBuilder(\n  pinner: Pinner,\n  data: object,\n): PinataUploadBuilder<PinataUploadResult> {\n  return new EncodedUploadBuilder(pinner, (name, keyvalues) =>\n    jsonToFile(data, { name, keyvalues }),\n  );\n}\n\n/**\n * Create a base64 upload builder.\n */\nexport function createBase64UploadBuilder(\n  pinner: Pinner,\n  base64String: string,\n): PinataUploadBuilder<PinataUploadResult> {\n  return new EncodedUploadBuilder(pinner, (name, keyvalues) =>\n    base64ToFile(base64String, { name, keyvalues }),\n  );\n}\n\n/**\n * Create a URL upload builder.\n */\nexport function createUrlUploadBuilder(\n  pinner: Pinner,\n  urlString: string,\n  options?: UrlUploadBuilderOptions,\n): PinataUploadBuilder<PinataUploadResult> {\n  // Validate URL to prevent SSRF attacks\n  validateUrl(urlString);\n\n  return new EncodedUploadBuilder(pinner, (name, keyvalues) =>\n    urlToFile(urlString, { name, keyvalues, fetch: options?.fetch }),\n  );\n}\n\n/**\n * Create a CID upload builder.\n */\nexport function createCidUploadBuilder(\n  pinner: Pinner,\n  cidString: string,\n): PinataUploadBuilder<void> {\n  return new CidUploadBuilder(pinner, cidString);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+const require_builder = require('./builder.cjs');
+const require_list_builder = require('./list-builder.cjs');
+const require_adapter = require('./adapter.cjs');

package/dist/cjs/adapters/pinata/list-builder.cjs

@@ -0,0 +1,52 @@
+
+//#region src/adapters/pinata/list-builder.ts
+/**
+* List builder for listing pins.
+*
+* Note: .pageToken() provides Pinata SDK API compatibility for easier migration.
+* The token is passed through to the underlying IPFS Pinning Service cursor parameter.
+* The server handles the actual pagination logic according to the IPFS Pinning Service spec.
+*/
+var PinataListBuilderImpl = class {
+	_limit;
+	_pageToken;
+	_offset;
+	constructor(pinner) {
+		this.pinner = pinner;
+	}
+	limit(limit) {
+		this._limit = limit;
+		return this;
+	}
+	offset(offset) {
+		this._offset = offset;
+		return this;
+	}
+	pageToken(pageToken) {
+		this._pageToken = pageToken;
+		return this;
+	}
+	async execute() {
+		const options = {};
+		if (this._limit !== void 0) options.limit = this._limit;
+		if (this._pageToken !== void 0) options.cursor = this._pageToken;
+		return (await this.pinner.listPins(options)).map((pin) => ({
+			id: pin.cid.toString(),
+			ipfsPinHash: pin.cid.toString(),
+			size: pin.size || 0,
+			name: pin.name || "",
+			cid: pin.cid.toString(),
+			createdAt: pin.created.toISOString()
+		}));
+	}
+};
+/**
+* Create a list builder.
+*/
+function createListBuilder(pinner) {
+	return new PinataListBuilderImpl(pinner);
+}
+
+//#endregion
+exports.createListBuilder = createListBuilder;
+//# sourceMappingURL=list-builder.cjs.map

package/dist/cjs/adapters/pinata/list-builder.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-builder.cjs","names":[],"sources":["../../../../src/adapters/pinata/list-builder.ts"],"sourcesContent":["import type { Pinner } from \"@/pinner\";\nimport type { PinataFile, PinataListBuilder } from \"@/types/pinata\";\nimport type { RemoteLsOptions } from \"@/types/pin\";\n\n/**\n * List builder for listing pins.\n *\n * Note: .pageToken() provides Pinata SDK API compatibility for easier migration.\n * The token is passed through to the underlying IPFS Pinning Service cursor parameter.\n * The server handles the actual pagination logic according to the IPFS Pinning Service spec.\n */\nclass PinataListBuilderImpl implements PinataListBuilder<PinataFile[]> {\n  private _limit?: number;\n  private _pageToken?: string;\n  private _offset?: number;\n\n  constructor(private pinner: Pinner) {}\n\n  limit(limit: number): this {\n    this._limit = limit;\n    return this;\n  }\n\n  offset(offset: number): this {\n    this._offset = offset;\n    return this;\n  }\n\n  pageToken(pageToken: string): this {\n    this._pageToken = pageToken;\n    return this;\n  }\n\n  async execute(): Promise<PinataFile[]> {\n    const options: RemoteLsOptions = {};\n\n    if (this._limit !== undefined) {\n      options.limit = this._limit;\n    }\n\n    if (this._pageToken !== undefined) {\n      options.cursor = this._pageToken;\n    }\n\n    const remotePins = await this.pinner.listPins(options);\n\n    return remotePins.map((pin) => ({\n      id: pin.cid.toString(),\n      ipfsPinHash: pin.cid.toString(),\n      size: pin.size || 0,\n      name: pin.name || \"\",\n      cid: pin.cid.toString(),\n      createdAt: pin.created.toISOString(),\n    }));\n  }\n}\n\n/**\n * Create a list builder.\n */\nexport function createListBuilder(\n  pinner: Pinner,\n): PinataListBuilder<PinataFile[]> {\n  return new PinataListBuilderImpl(pinner);\n}\n"],"mappings":";;;;;;;;;AAWA,IAAM,wBAAN,MAAuE;CACrE,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YAAY,AAAQ,QAAgB;EAAhB;;CAEpB,MAAM,OAAqB;AACzB,OAAK,SAAS;AACd,SAAO;;CAGT,OAAO,QAAsB;AAC3B,OAAK,UAAU;AACf,SAAO;;CAGT,UAAU,WAAyB;AACjC,OAAK,aAAa;AAClB,SAAO;;CAGT,MAAM,UAAiC;EACrC,MAAM,UAA2B,EAAE;AAEnC,MAAI,KAAK,WAAW,OAClB,SAAQ,QAAQ,KAAK;AAGvB,MAAI,KAAK,eAAe,OACtB,SAAQ,SAAS,KAAK;AAKxB,UAFmB,MAAM,KAAK,OAAO,SAAS,QAAQ,EAEpC,KAAK,SAAS;GAC9B,IAAI,IAAI,IAAI,UAAU;GACtB,aAAa,IAAI,IAAI,UAAU;GAC/B,MAAM,IAAI,QAAQ;GAClB,MAAM,IAAI,QAAQ;GAClB,KAAK,IAAI,IAAI,UAAU;GACvB,WAAW,IAAI,QAAQ,aAAa;GACrC,EAAE;;;;;;AAOP,SAAgB,kBACd,QACiC;AACjC,QAAO,IAAI,sBAAsB,OAAO"}

package/dist/cjs/blockstore/index.cjs

@@ -0,0 +1,2 @@
+const require_unstorage_base = require('./unstorage-base.cjs');
+const require_unstorage = require('./unstorage.cjs');