@lumeweb/pinner 0.1.0 → 0.1.1

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

@@ -1,187 +0,0 @@
-import { jsonToFile } from "../../encoder/json.js";
-import { base64ToFile } from "../../encoder/base64.js";
-import { urlToFile } from "../../encoder/url.js";
-import "../../encoder/index.js";
-import { validateUrl } from "../../utils/validation.js";
-import { CID } from "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 = 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) => jsonToFile(data, {
-		name,
-		keyvalues
-	}));
-}
-/**
-* Create a base64 upload builder.
-*/
-function createBase64UploadBuilder(pinner, base64String) {
-	return new EncodedUploadBuilder(pinner, (name, keyvalues) => base64ToFile(base64String, {
-		name,
-		keyvalues
-	}));
-}
-/**
-* Create a URL upload builder.
-*/
-function createUrlUploadBuilder(pinner, urlString, options) {
-	validateUrl(urlString);
-	return new EncodedUploadBuilder(pinner, (name, keyvalues) => urlToFile(urlString, {
-		name,
-		keyvalues,
-		fetch: options?.fetch
-	}));
-}
-/**
-* Create a CID upload builder.
-*/
-function createCidUploadBuilder(pinner, cidString) {
-	return new CidUploadBuilder(pinner, cidString);
-}
-
-//#endregion
-export { PinataAdapterError, createBase64UploadBuilder, createCidUploadBuilder, createFileArrayUploadBuilder, createJsonUploadBuilder, createUploadBuilder, createUrlUploadBuilder };
-//# sourceMappingURL=builder.js.map

package/dist/esm/adapters/pinata/builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"builder.js","names":[],"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/esm/adapters/pinata/list-builder.d.ts

@@ -1 +0,0 @@
-import "../../pinner.js";

package/dist/esm/adapters/pinata/list-builder.js

@@ -1,51 +0,0 @@
-//#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
-export { createListBuilder };
-//# sourceMappingURL=list-builder.js.map

package/dist/esm/adapters/pinata/list-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-builder.js","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/esm/types/pinata.d.ts

@@ -1,99 +0,0 @@
-//#region src/types/pinata.d.ts
-interface PinataUploadResult {
-  /**
-   * IPFS CID.
-   */
-  IpfsHash: string;
-  /**
-   * Pin size in bytes.
-   */
-  PinSize: number;
-  /**
-   * Timestamp of upload.
-   */
-  Timestamp: string;
-  /**
-   * Whether content was pinned.
-   */
-  isDuplicate: boolean;
-}
-/**
- * Base metadata options - shared across upload and pin operations.
- */
-interface PinataMetadataOptions {
-  name?: string;
-  keyvalues?: Record<string, string>;
-}
-/**
- * Generic upload builder interface.
- * All upload methods return this builder with different result types.
- */
-interface PinataUploadBuilder<T = PinataUploadResult> {
-  name(name: string): this;
-  keyvalues(kv: Record<string, string>): this;
-  execute(): Promise<T>;
-}
-/**
- * Options for pinning content by CID.
- */
-interface PinByHashOptions extends PinataMetadataOptions {}
-/**
- * Pin information (Pinata SDK format).
- * Note: This differs from RemotePin (@ipfs-shipyard/pinning-service-client format).
- */
-interface PinataPin {
-  id: string;
-  ipfsPinHash: string;
-  size: number;
-  userId: string;
-  datePinned: string;
-  dateUnpinned?: string;
-  metadata?: PinataMetadata;
-}
-/**
- * File information (Pinata SDK format).
- */
-interface PinataFile {
-  id: string;
-  ipfsPinHash: string;
-  size: number;
-  name: string;
-  cid: string;
-  createdAt: string;
-}
-/**
- * List builder interface for listing pins.
- * Uses cursor-based pagination compatible with Pinata SDK.
- */
-interface PinataListBuilder<T = PinataFile[]> {
-  limit(limit: number): this;
-  pageToken(pageToken: string): this;
-  execute(): Promise<T>;
-}
-/**
- * Pin metadata.
- */
-interface PinataMetadata extends PinataMetadataOptions {}
-/**
- * File information.
- */
-interface PinataFile {
-  id: string;
-  ipfsPinHash: string;
-  size: number;
-  name: string;
-  mimeType?: string;
-  cid: string;
-  createdAt: string;
-}
-/**
- * Generic list builder interface.
- */
-interface PinataListBuilder<T> {
-  limit(limit: number): this;
-  offset(offset: number): this;
-  execute(): Promise<T>;
-}
-//#endregion
-export { PinByHashOptions, PinataFile, PinataListBuilder, PinataMetadata, PinataMetadataOptions, PinataPin, PinataUploadBuilder, PinataUploadResult };
-//# sourceMappingURL=pinata.d.ts.map