@lumeweb/pinner 0.0.1 → 0.1.0

package/dist/cjs/pin/client.cjs

@@ -0,0 +1,96 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_index = require('../errors/index.cjs');
+let multiformats_cid = require("multiformats/cid");
+let _ipfs_shipyard_pinning_service_client = require("@ipfs-shipyard/pinning-service-client");
+
+//#region src/pin/client.ts
+var PinClient = class {
+	client = null;
+	config;
+	constructor(config) {
+		this.config = config;
+	}
+	getClient() {
+		if (this.client) return this.client;
+		if (!this.config.jwt) throw new require_index.ConfigurationError("JWT token is required");
+		this.client = new _ipfs_shipyard_pinning_service_client.RemotePinningServiceClient(new _ipfs_shipyard_pinning_service_client.Configuration({
+			endpointUrl: this.config.endpoint,
+			accessToken: this.config.jwt,
+			fetchApi: this.config.fetch ?? fetch
+		}));
+		return this.client;
+	}
+	async *add(cid, options) {
+		const client = this.getClient();
+		const pin = {
+			cid: cid.toString(),
+			name: options?.name,
+			meta: options?.metadata,
+			origins: options?.origins
+		};
+		await client.pinsPost({ pin }, { signal: options?.signal });
+		yield cid;
+	}
+	async *ls(options) {
+		const response = await this.getClient().pinsGet(this.normalizeListOptions(options), { signal: options?.signal });
+		for (const result of response.results) yield this.mapResponse(result);
+	}
+	async isPinned(cid, options) {
+		try {
+			await this.get(cid, options);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async get(cid, options) {
+		const response = await this.getClient().pinsGet({ cid: [cid.toString()] }, { signal: options?.signal });
+		if (response.results.length === 0) throw new require_index.NotFoundError(`Pin not found for CID: ${cid.toString()}`);
+		return this.mapResponse(response.results[0]);
+	}
+	async setMetadata(cid, metadata, options) {
+		const client = this.getClient();
+		const response = await client.pinsGet({ cid: [cid.toString()] }, { signal: options?.signal });
+		if (response.results.length === 0) throw new require_index.NotFoundError(`Pin not found for CID: ${cid.toString()}`);
+		const pin = response.results[0];
+		await client.pinsRequestidPost({
+			requestid: pin.requestid,
+			pin: {
+				cid: pin.pin.cid,
+				name: pin.pin.name,
+				meta: metadata,
+				origins: pin.pin.origins
+			}
+		}, { signal: options?.signal });
+	}
+	async *rm(cid, options) {
+		const client = this.getClient();
+		const response = await client.pinsGet({ cid: [cid.toString()] }, { signal: options?.signal });
+		await Promise.all([...response.results].map(async (result) => {
+			return client.pinsRequestidDelete({ requestid: result.requestid }, { signal: options?.signal });
+		}));
+		yield cid;
+	}
+	mapResponse(response) {
+		return {
+			cid: multiformats_cid.CID.parse(response.pin.cid),
+			name: response.pin.name,
+			status: response.status,
+			created: response.created,
+			size: response.pin.meta?.size ? parseInt(response.pin.meta.size, 10) : void 0,
+			metadata: response.pin.meta
+		};
+	}
+	normalizeListOptions(options) {
+		const request = {};
+		if (options?.limit !== void 0) request.limit = options.limit;
+		if (options?.cursor !== void 0) request.after = options.cursor;
+		if (options?.status !== void 0) request.status = options.status;
+		if (options?.name !== void 0) request.name = options.name;
+		return request;
+	}
+};
+
+//#endregion
+exports.PinClient = PinClient;
+//# sourceMappingURL=client.cjs.map

package/dist/cjs/pin/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","names":["ConfigurationError","RemotePinningServiceClient","Configuration","NotFoundError","CID"],"sources":["../../../src/pin/client.ts"],"sourcesContent":["import {\n  Configuration,\n  type Pin,\n  type PinStatus,\n  RemotePinningServiceClient,\n} from \"@ipfs-shipyard/pinning-service-client\";\nimport type { PinnerConfig } from \"../config\";\nimport type {\n  AbortOptions,\n  RemoteAddOptions,\n  RemoteLsOptions,\n  RemotePin,\n  RemotePins,\n} from \"@/types/pin\";\nimport { CID } from \"multiformats/cid\";\nimport { ConfigurationError, NotFoundError } from \"@/errors\";\n\nexport class PinClient implements RemotePins {\n  private client: RemotePinningServiceClient | null = null;\n  private config: PinnerConfig;\n\n  constructor(config: PinnerConfig) {\n    this.config = config;\n  }\n\n  protected getClient(): RemotePinningServiceClient {\n    if (this.client) {\n      return this.client;\n    }\n\n    if (!this.config.jwt) {\n      throw new ConfigurationError(\"JWT token is required\");\n    }\n\n    const configuration = new Configuration({\n      endpointUrl: this.config.endpoint,\n      accessToken: this.config.jwt,\n      fetchApi: this.config.fetch ?? fetch,\n    });\n\n    this.client = new RemotePinningServiceClient(configuration);\n    return this.client;\n  }\n\n  async *add(\n    cid: CID,\n    options?: RemoteAddOptions,\n  ): AsyncGenerator<CID, void, undefined> {\n    const client = this.getClient();\n\n    const pin: Pin = {\n      cid: cid.toString(),\n      name: options?.name,\n      meta: options?.metadata,\n      origins: options?.origins,\n    };\n\n    await client.pinsPost({ pin }, { signal: options?.signal });\n\n    yield cid;\n  }\n\n  async *ls(\n    options?: RemoteLsOptions,\n  ): AsyncGenerator<RemotePin, void, undefined> {\n    const client = this.getClient();\n    const response = await client.pinsGet(this.normalizeListOptions(options), {\n      signal: options?.signal,\n    });\n\n    for (const result of response.results) {\n      yield this.mapResponse(result);\n    }\n  }\n\n  async isPinned(cid: CID, options?: AbortOptions): Promise<boolean> {\n    try {\n      await this.get(cid, options);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async get(cid: CID, options?: AbortOptions): Promise<RemotePin> {\n    const client = this.getClient();\n    const response = await client.pinsGet(\n      { cid: [cid.toString()] },\n      {\n        signal: options?.signal,\n      },\n    );\n\n    if (response.results.length === 0) {\n      throw new NotFoundError(`Pin not found for CID: ${cid.toString()}`);\n    }\n\n    return this.mapResponse(response.results[0]);\n  }\n\n  async setMetadata(\n    cid: CID,\n    metadata: Record<string, string> | undefined,\n    options?: AbortOptions,\n  ): Promise<void> {\n    const client = this.getClient();\n    const response = await client.pinsGet(\n      { cid: [cid.toString()] },\n      {\n        signal: options?.signal,\n      },\n    );\n\n    if (response.results.length === 0) {\n      throw new NotFoundError(`Pin not found for CID: ${cid.toString()}`);\n    }\n\n    const pin = response.results[0];\n    await client.pinsRequestidPost(\n      {\n        requestid: pin.requestid,\n        pin: {\n          cid: pin.pin.cid,\n          name: pin.pin.name,\n          meta: metadata,\n          origins: pin.pin.origins,\n        },\n      },\n      { signal: options?.signal },\n    );\n  }\n\n  async *rm(\n    cid: CID,\n    options?: AbortOptions,\n  ): AsyncGenerator<CID, void, undefined> {\n    const client = this.getClient();\n    const response = await client.pinsGet(\n      { cid: [cid.toString()] },\n      { signal: options?.signal },\n    );\n\n    await Promise.all(\n      [...response.results].map(async (result) => {\n        return client.pinsRequestidDelete(\n          { requestid: result.requestid },\n          { signal: options?.signal },\n        );\n      }),\n    );\n\n    yield cid;\n  }\n\n  private mapResponse(response: PinStatus): RemotePin {\n    return {\n      cid: CID.parse(response.pin.cid),\n      name: response.pin.name,\n      status: response.status,\n      created: response.created,\n      size: response.pin.meta?.size\n        ? parseInt(response.pin.meta.size, 10)\n        : undefined,\n      metadata: response.pin.meta,\n    };\n  }\n\n  private normalizeListOptions(\n    options?: RemoteLsOptions,\n  ): Record<string, unknown> {\n    const request: Record<string, unknown> = {};\n\n    if (options?.limit !== undefined) {\n      request.limit = options.limit;\n    }\n    if (options?.cursor !== undefined) {\n      request.after = options.cursor;\n    }\n    if (options?.status !== undefined) {\n      request.status = options.status;\n    }\n    if (options?.name !== undefined) {\n      request.name = options.name;\n    }\n\n    return request;\n  }\n}\n"],"mappings":"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"}

package/dist/cjs/pin/index.cjs

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

package/dist/cjs/pinner.cjs

@@ -0,0 +1,126 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_manager = require('./upload/manager.cjs');
+const require_builder = require('./upload/builder.cjs');
+require('./upload/index.cjs');
+const require_client = require('./pin/client.cjs');
+require('./pin/index.cjs');
+let multiformats_cid = require("multiformats/cid");
+
+//#region src/pinner.ts
+var Pinner = class {
+	uploadManager;
+	_pins;
+	_upload;
+	constructor(config) {
+		this.uploadManager = new require_manager.UploadManager(config);
+		this._pins = new require_client.PinClient(config);
+	}
+	/**
+	* Access the remote pins interface.
+	*/
+	get pins() {
+		return this._pins;
+	}
+	/**
+	* Upload interface that works as both a method and a builder namespace.
+	*
+	* As a method: upload(file, options) -> UploadOperation
+	* As a property: upload.file(), upload.json(), etc. -> Builder
+	*/
+	get upload() {
+		if (!this._upload) {
+			const builderNamespace = require_builder.createUploadBuilderNamespace(this);
+			const uploadMethod = async (file, options) => {
+				return this.uploadManager.upload(file, options);
+			};
+			this._upload = new Proxy(uploadMethod, { get(target, prop) {
+				if (prop in builderNamespace) return Reflect.get(builderNamespace, prop);
+				return Reflect.get(target, prop);
+			} });
+		}
+		return this._upload;
+	}
+	/**
+	* Upload a file and wait for completion.
+	* Convenience method for simple use cases where controls aren't needed.
+	*/
+	async uploadAndWait(file, options) {
+		return (await this.upload(file, options)).result;
+	}
+	/**
+	* Wait for an operation to complete or reach a settled state.
+	* @param input Either an operation ID (number) or an UploadResult
+	* @param options Polling options (interval, timeout, settledStates)
+	* @returns UploadResult with operation status merged in
+	*/
+	async waitForOperation(input, options) {
+		return this.uploadManager.waitForOperation(input, options);
+	}
+	/**
+	* Upload a directory to IPFS.
+	*/
+	async uploadDirectory(files, options) {
+		return this.uploadManager.uploadDirectory(files, options);
+	}
+	/**
+	* Upload a CAR file without preprocessing.
+	* This is useful for passthrough of pre-generated CAR files.
+	*/
+	async uploadCar(file, options) {
+		return this.uploadManager.uploadCar(file, options);
+	}
+	/**
+	* Pin existing content by CID.
+	*/
+	async pinByHash(cid, options) {
+		const cidObj = typeof cid === "string" ? multiformats_cid.CID.parse(cid) : cid;
+		return this.pins.add(cidObj, options);
+	}
+	/**
+	* List pinned content.
+	*/
+	async listPins(options) {
+		const pins = [];
+		for await (const pin of this.pins.ls(options)) pins.push(pin);
+		return pins;
+	}
+	/**
+	* Get pin status.
+	*/
+	async getPinStatus(cid) {
+		const cidObj = typeof cid === "string" ? multiformats_cid.CID.parse(cid) : cid;
+		return this.pins.get(cidObj);
+	}
+	/**
+	* Check if content is pinned.
+	*/
+	async isPinned(cid) {
+		const cidObj = typeof cid === "string" ? multiformats_cid.CID.parse(cid) : cid;
+		return this.pins.isPinned(cidObj);
+	}
+	/**
+	* Update pin metadata.
+	*/
+	async setPinMetadata(cid, metadata) {
+		const cidObj = typeof cid === "string" ? multiformats_cid.CID.parse(cid) : cid;
+		return this.pins.setMetadata(cidObj, metadata);
+	}
+	/**
+	* Remove a pin. The block may be deleted when garbage collection is run.
+	*/
+	async unpin(cid, options) {
+		const cidObj = typeof cid === "string" ? multiformats_cid.CID.parse(cid) : cid;
+		const generator = this.pins.rm(cidObj, options);
+		for await (const _ of generator);
+	}
+	/**
+	* Destroy the client and cleanup resources.
+	*/
+	destroy() {
+		this.uploadManager.destroy();
+	}
+};
+
+//#endregion
+exports.Pinner = Pinner;
+//# sourceMappingURL=pinner.cjs.map

package/dist/cjs/pinner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinner.cjs","names":["UploadManager","PinClient","createUploadBuilderNamespace","CID"],"sources":["../../src/pinner.ts"],"sourcesContent":["import type { PinnerConfig } from \"./config\";\nimport { UploadManager } from \"./upload\";\nimport { PinClient } from \"./pin\";\nimport type { UploadMethodAndBuilder } from \"@/upload/builder\";\nimport { createUploadBuilderNamespace } from \"@/upload/builder\";\nimport type {\n  UploadOperation,\n  UploadOptions,\n  UploadResult,\n} from \"@/types/upload\";\nimport type { OperationPollingOptions } from \"@lumeweb/portal-sdk\";\nimport type {\n  AbortOptions,\n  RemoteAddOptions,\n  RemoteLsOptions,\n  RemotePin,\n  RemotePins,\n} from \"@/types/pin\";\nimport { CID } from \"multiformats/cid\";\n\nexport class Pinner {\n  private uploadManager: UploadManager;\n  private _pins: RemotePins;\n  private _upload?: UploadMethodAndBuilder;\n\n  constructor(config: PinnerConfig) {\n    this.uploadManager = new UploadManager(config);\n    this._pins = new PinClient(config);\n  }\n\n  /**\n   * Access the remote pins interface.\n   */\n  get pins(): RemotePins {\n    return this._pins;\n  }\n\n  /**\n   * Upload interface that works as both a method and a builder namespace.\n   *\n   * As a method: upload(file, options) -> UploadOperation\n   * As a property: upload.file(), upload.json(), etc. -> Builder\n   */\n  get upload(): UploadMethodAndBuilder {\n    if (!this._upload) {\n      const builderNamespace = createUploadBuilderNamespace(this);\n      const uploadMethod = async (\n        file: File,\n        options?: UploadOptions,\n      ): Promise<UploadOperation> => {\n        return this.uploadManager.upload(file, options);\n      };\n\n      this._upload = new Proxy(uploadMethod, {\n        get(target, prop) {\n          if (prop in builderNamespace) {\n            return Reflect.get(builderNamespace, prop);\n          }\n          return Reflect.get(target, prop);\n        },\n      }) as UploadMethodAndBuilder;\n    }\n    return this._upload;\n  }\n\n  /**\n   * Upload a file and wait for completion.\n   * Convenience method for simple use cases where controls aren't needed.\n   */\n  async uploadAndWait(\n    file: File,\n    options?: UploadOptions,\n  ): Promise<UploadResult> {\n    const operation = await this.upload(file, options);\n    return operation.result;\n  }\n\n  /**\n   * Wait for an operation to complete or reach a settled state.\n   * @param input Either an operation ID (number) or an UploadResult\n   * @param options Polling options (interval, timeout, settledStates)\n   * @returns UploadResult with operation status merged in\n   */\n  async waitForOperation(\n    input: number | UploadResult,\n    options?: OperationPollingOptions,\n  ): Promise<UploadResult> {\n    return this.uploadManager.waitForOperation(input, options);\n  }\n\n  /**\n   * Upload a directory to IPFS.\n   */\n  async uploadDirectory(\n    files: File[],\n    options?: UploadOptions,\n  ): Promise<UploadOperation> {\n    return this.uploadManager.uploadDirectory(files, options);\n  }\n\n  /**\n   * Upload a CAR file without preprocessing.\n   * This is useful for passthrough of pre-generated CAR files.\n   */\n  async uploadCar(\n    file: File | ReadableStream<Uint8Array>,\n    options?: UploadOptions,\n  ): Promise<UploadOperation> {\n    return this.uploadManager.uploadCar(file, options);\n  }\n\n  /**\n   * Pin existing content by CID.\n   */\n  async pinByHash(\n    cid: string | CID,\n    options?: RemoteAddOptions,\n  ): Promise<AsyncGenerator<CID, void, undefined>> {\n    const cidObj = typeof cid === \"string\" ? CID.parse(cid) : cid;\n    return this.pins.add(cidObj, options);\n  }\n\n  /**\n   * List pinned content.\n   */\n  async listPins(options?: RemoteLsOptions): Promise<RemotePin[]> {\n    const pins: RemotePin[] = [];\n    for await (const pin of this.pins.ls(options)) {\n      pins.push(pin);\n    }\n    return pins;\n  }\n\n  /**\n   * Get pin status.\n   */\n  async getPinStatus(cid: string | CID): Promise<RemotePin> {\n    const cidObj = typeof cid === \"string\" ? CID.parse(cid) : cid;\n    return this.pins.get(cidObj);\n  }\n\n  /**\n   * Check if content is pinned.\n   */\n  async isPinned(cid: string | CID): Promise<boolean> {\n    const cidObj = typeof cid === \"string\" ? CID.parse(cid) : cid;\n    return this.pins.isPinned(cidObj);\n  }\n\n  /**\n   * Update pin metadata.\n   */\n  async setPinMetadata(\n    cid: string | CID,\n    metadata: Record<string, string> | undefined,\n  ): Promise<void> {\n    const cidObj = typeof cid === \"string\" ? CID.parse(cid) : cid;\n    return this.pins.setMetadata(cidObj, metadata);\n  }\n\n  /**\n   * Remove a pin. The block may be deleted when garbage collection is run.\n   */\n  async unpin(cid: string | CID, options?: AbortOptions): Promise<void> {\n    const cidObj = typeof cid === \"string\" ? CID.parse(cid) : cid;\n    const generator = this.pins.rm(cidObj, options);\n    for await (const _ of generator) {\n      // Consume the generator to complete the unpin operation\n    }\n  }\n\n  /**\n   * Destroy the client and cleanup resources.\n   */\n  destroy(): void {\n    this.uploadManager.destroy();\n  }\n}\n"],"mappings":";;;;;;;;;AAoBA,IAAa,SAAb,MAAoB;CAClB,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YAAY,QAAsB;AAChC,OAAK,gBAAgB,IAAIA,8BAAc,OAAO;AAC9C,OAAK,QAAQ,IAAIC,yBAAU,OAAO;;;;;CAMpC,IAAI,OAAmB;AACrB,SAAO,KAAK;;;;;;;;CASd,IAAI,SAAiC;AACnC,MAAI,CAAC,KAAK,SAAS;GACjB,MAAM,mBAAmBC,6CAA6B,KAAK;GAC3D,MAAM,eAAe,OACnB,MACA,YAC6B;AAC7B,WAAO,KAAK,cAAc,OAAO,MAAM,QAAQ;;AAGjD,QAAK,UAAU,IAAI,MAAM,cAAc,EACrC,IAAI,QAAQ,MAAM;AAChB,QAAI,QAAQ,iBACV,QAAO,QAAQ,IAAI,kBAAkB,KAAK;AAE5C,WAAO,QAAQ,IAAI,QAAQ,KAAK;MAEnC,CAAC;;AAEJ,SAAO,KAAK;;;;;;CAOd,MAAM,cACJ,MACA,SACuB;AAEvB,UADkB,MAAM,KAAK,OAAO,MAAM,QAAQ,EACjC;;;;;;;;CASnB,MAAM,iBACJ,OACA,SACuB;AACvB,SAAO,KAAK,cAAc,iBAAiB,OAAO,QAAQ;;;;;CAM5D,MAAM,gBACJ,OACA,SAC0B;AAC1B,SAAO,KAAK,cAAc,gBAAgB,OAAO,QAAQ;;;;;;CAO3D,MAAM,UACJ,MACA,SAC0B;AAC1B,SAAO,KAAK,cAAc,UAAU,MAAM,QAAQ;;;;;CAMpD,MAAM,UACJ,KACA,SAC+C;EAC/C,MAAM,SAAS,OAAO,QAAQ,WAAWC,qBAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,IAAI,QAAQ,QAAQ;;;;;CAMvC,MAAM,SAAS,SAAiD;EAC9D,MAAM,OAAoB,EAAE;AAC5B,aAAW,MAAM,OAAO,KAAK,KAAK,GAAG,QAAQ,CAC3C,MAAK,KAAK,IAAI;AAEhB,SAAO;;;;;CAMT,MAAM,aAAa,KAAuC;EACxD,MAAM,SAAS,OAAO,QAAQ,WAAWA,qBAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;CAM9B,MAAM,SAAS,KAAqC;EAClD,MAAM,SAAS,OAAO,QAAQ,WAAWA,qBAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,SAAS,OAAO;;;;;CAMnC,MAAM,eACJ,KACA,UACe;EACf,MAAM,SAAS,OAAO,QAAQ,WAAWA,qBAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,YAAY,QAAQ,SAAS;;;;;CAMhD,MAAM,MAAM,KAAmB,SAAuC;EACpE,MAAM,SAAS,OAAO,QAAQ,WAAWA,qBAAI,MAAM,IAAI,GAAG;EAC1D,MAAM,YAAY,KAAK,KAAK,GAAG,QAAQ,QAAQ;AAC/C,aAAW,MAAM,KAAK;;;;;CAQxB,UAAgB;AACd,OAAK,cAAc,SAAS"}

package/dist/cjs/pinner.d.cts

@@ -0,0 +1,77 @@
+import { PinnerConfig } from "./config.cjs";
+import { UploadOperation, UploadOptions, UploadResult } from "./types/upload.cjs";
+import { UploadMethodAndBuilder } from "./upload/builder.cjs";
+import { AbortOptions, RemoteAddOptions, RemoteLsOptions, RemotePin, RemotePins } from "./types/pin.cjs";
+import { OperationPollingOptions } from "@lumeweb/portal-sdk";
+import { CID } from "multiformats/cid";
+
+//#region src/pinner.d.ts
+declare class Pinner {
+  private uploadManager;
+  private _pins;
+  private _upload?;
+  constructor(config: PinnerConfig);
+  /**
+   * Access the remote pins interface.
+   */
+  get pins(): RemotePins;
+  /**
+   * Upload interface that works as both a method and a builder namespace.
+   *
+   * As a method: upload(file, options) -> UploadOperation
+   * As a property: upload.file(), upload.json(), etc. -> Builder
+   */
+  get upload(): UploadMethodAndBuilder;
+  /**
+   * Upload a file and wait for completion.
+   * Convenience method for simple use cases where controls aren't needed.
+   */
+  uploadAndWait(file: File, options?: UploadOptions): Promise<UploadResult>;
+  /**
+   * Wait for an operation to complete or reach a settled state.
+   * @param input Either an operation ID (number) or an UploadResult
+   * @param options Polling options (interval, timeout, settledStates)
+   * @returns UploadResult with operation status merged in
+   */
+  waitForOperation(input: number | UploadResult, options?: OperationPollingOptions): Promise<UploadResult>;
+  /**
+   * Upload a directory to IPFS.
+   */
+  uploadDirectory(files: File[], options?: UploadOptions): Promise<UploadOperation>;
+  /**
+   * Upload a CAR file without preprocessing.
+   * This is useful for passthrough of pre-generated CAR files.
+   */
+  uploadCar(file: File | ReadableStream<Uint8Array>, options?: UploadOptions): Promise<UploadOperation>;
+  /**
+   * Pin existing content by CID.
+   */
+  pinByHash(cid: string | CID, options?: RemoteAddOptions): Promise<AsyncGenerator<CID, void, undefined>>;
+  /**
+   * List pinned content.
+   */
+  listPins(options?: RemoteLsOptions): Promise<RemotePin[]>;
+  /**
+   * Get pin status.
+   */
+  getPinStatus(cid: string | CID): Promise<RemotePin>;
+  /**
+   * Check if content is pinned.
+   */
+  isPinned(cid: string | CID): Promise<boolean>;
+  /**
+   * Update pin metadata.
+   */
+  setPinMetadata(cid: string | CID, metadata: Record<string, string> | undefined): Promise<void>;
+  /**
+   * Remove a pin. The block may be deleted when garbage collection is run.
+   */
+  unpin(cid: string | CID, options?: AbortOptions): Promise<void>;
+  /**
+   * Destroy the client and cleanup resources.
+   */
+  destroy(): void;
+}
+//#endregion
+export { Pinner };
+//# sourceMappingURL=pinner.d.cts.map

package/dist/cjs/types/constants.cjs

@@ -0,0 +1,34 @@
+
+//#region src/types/constants.ts
+/**
+* Default API endpoint URL for the pinning service.
+*/
+const DEFAULT_ENDPOINT = "https://api.lumeweb.com";
+/**
+* Default TUS upload size threshold (100MB).
+* Files larger than this will use TUS protocol for resumable uploads.
+*/
+const TUS_SIZE_THRESHOLD = 100 * 1024 * 1024;
+/**
+* Default key prefix for blockstore keys.
+* This is prepended to CID strings in storage keys.
+*/
+const DEFAULT_BLOCKSTORE_PREFIX = "pinner-helia-blocks";
+/**
+* Default base path for blockstore storage driver.
+* For IndexedDB: "pinner:" - the database name prefix
+* For filesystem: "./.pinner-blocks" - the directory path
+*/
+const DEFAULT_BLOCKSTORE_BASE = "pinner:";
+/**
+* Default base path for blockstore filesystem storage driver (Node.js).
+*/
+const DEFAULT_BLOCKSTORE_FS_BASE = "./.pinner-blocks";
+
+//#endregion
+exports.DEFAULT_BLOCKSTORE_BASE = DEFAULT_BLOCKSTORE_BASE;
+exports.DEFAULT_BLOCKSTORE_FS_BASE = DEFAULT_BLOCKSTORE_FS_BASE;
+exports.DEFAULT_BLOCKSTORE_PREFIX = DEFAULT_BLOCKSTORE_PREFIX;
+exports.DEFAULT_ENDPOINT = DEFAULT_ENDPOINT;
+exports.TUS_SIZE_THRESHOLD = TUS_SIZE_THRESHOLD;
+//# sourceMappingURL=constants.cjs.map

package/dist/cjs/types/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/types/constants.ts"],"sourcesContent":["/**\n * Default API endpoint URL for the pinning service.\n */\nexport const DEFAULT_ENDPOINT = \"https://api.lumeweb.com\";\n\n/**\n * Default IPFS gateway URL for content retrieval.\n */\nexport const DEFAULT_GATEWAY = \"https://gateway.lumeweb.com\";\n\n/**\n * Default TUS upload size threshold (100MB).\n * Files larger than this will use TUS protocol for resumable uploads.\n */\nexport const TUS_SIZE_THRESHOLD = 100 * 1024 * 1024;\n\n/**\n * Default base path for Helia datastore storage.\n */\nexport const DEFAULT_DATASTORE_BASE = \"pinner-helia-data\";\n\n/**\n * Default key prefix for blockstore keys.\n * This is prepended to CID strings in storage keys.\n */\nexport const DEFAULT_BLOCKSTORE_PREFIX = \"pinner-helia-blocks\";\n\n/**\n * Default base path for blockstore storage driver.\n * For IndexedDB: \"pinner:\" - the database name prefix\n * For filesystem: \"./.pinner-blocks\" - the directory path\n */\nexport const DEFAULT_BLOCKSTORE_BASE = \"pinner:\";\n\n/**\n * Default base path for blockstore filesystem storage driver (Node.js).\n */\nexport const DEFAULT_BLOCKSTORE_FS_BASE = \"./.pinner-blocks\";\n\n/**\n * Default base path for datastore filesystem storage driver (Node.js).\n */\nexport const DEFAULT_DATASTORE_FS_BASE = \"./.pinner-data\";\n"],"mappings":";;;;;AAGA,MAAa,mBAAmB;;;;;AAWhC,MAAa,qBAAqB,MAAM,OAAO;;;;;AAW/C,MAAa,4BAA4B;;;;;;AAOzC,MAAa,0BAA0B;;;;AAKvC,MAAa,6BAA6B"}

package/dist/cjs/types/mime-types.cjs

@@ -0,0 +1,11 @@
+
+//#region src/types/mime-types.ts
+const MIME_TYPE_CAR = "application/vnd.ipld.car";
+const MIME_TYPE_OCTET_STREAM = "application/octet-stream";
+const FILE_EXTENSION_CAR = ".car";
+
+//#endregion
+exports.FILE_EXTENSION_CAR = FILE_EXTENSION_CAR;
+exports.MIME_TYPE_CAR = MIME_TYPE_CAR;
+exports.MIME_TYPE_OCTET_STREAM = MIME_TYPE_OCTET_STREAM;
+//# sourceMappingURL=mime-types.cjs.map

package/dist/cjs/types/mime-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-types.cjs","names":[],"sources":["../../../src/types/mime-types.ts"],"sourcesContent":["export const MIME_TYPE_CAR = \"application/vnd.ipld.car\";\nexport const MIME_TYPE_OCTET_STREAM = \"application/octet-stream\";\nexport const FILE_EXTENSION_CAR = \".car\";\n"],"mappings":";;AAAA,MAAa,gBAAgB;AAC7B,MAAa,yBAAyB;AACtC,MAAa,qBAAqB"}

package/dist/cjs/types/mime-types.d.cts

@@ -0,0 +1,7 @@
+//#region src/types/mime-types.d.ts
+declare const MIME_TYPE_CAR = "application/vnd.ipld.car";
+declare const MIME_TYPE_OCTET_STREAM = "application/octet-stream";
+declare const FILE_EXTENSION_CAR = ".car";
+//#endregion
+export { FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM };
+//# sourceMappingURL=mime-types.d.cts.map

package/dist/cjs/types/pin.d.cts

@@ -0,0 +1,74 @@
+import { CID } from "multiformats/cid";
+import { Status } from "@ipfs-shipyard/pinning-service-client";
+
+//#region src/types/pin.d.ts
+
+/**
+ * Options that can be passed to abort async operations
+ */
+interface AbortOptions {
+  signal?: AbortSignal;
+}
+/**
+ * Allows passing extra options accepted by the remote pinning service
+ */
+interface RemoteAddOptions extends AbortOptions {
+  name?: string;
+  metadata?: Record<string, string>;
+  origins?: string[];
+}
+/**
+ * Allows passing extra options accepted by the remote pinning service
+ */
+interface RemoteLsOptions extends AbortOptions {
+  name?: string;
+  status?: Status[];
+  limit?: number;
+  cursor?: string;
+}
+/**
+ * Includes extra metadata supported by the remote pinning service
+ */
+interface RemotePin {
+  cid: CID;
+  name?: string;
+  status: Status;
+  created: Date;
+  size?: number;
+  metadata?: Record<string, string>;
+}
+/**
+ * Extends the Pins interface with remote pinning-specific arguments and return
+ * types (e.g. metadata as `Record<string, string>` and pins with an added
+ * `.status` property)
+ */
+interface RemotePins {
+  /**
+   * Pin a block in the blockstore. It will not be deleted
+   * when garbage collection is run.
+   */
+  add(cid: CID, options?: RemoteAddOptions): AsyncGenerator<CID, void, undefined>;
+  /**
+   * List all blocks that have been pinned.
+   */
+  ls(options?: RemoteLsOptions): AsyncGenerator<RemotePin, void, undefined>;
+  /**
+   * Return true if the passed CID is pinned
+   */
+  isPinned(cid: CID, options?: AbortOptions): Promise<boolean>;
+  /**
+   * Return pin details
+   */
+  get(cid: CID, options?: AbortOptions): Promise<RemotePin>;
+  /**
+   * Update pin metadata
+   */
+  setMetadata(cid: CID, metadata: Record<string, string> | undefined, options?: AbortOptions): Promise<void>;
+  /**
+   * Remove a pin. The block may be deleted when garbage collection is run.
+   */
+  rm(cid: CID, options?: AbortOptions): AsyncGenerator<CID, void, undefined>;
+}
+//#endregion
+export { AbortOptions, RemoteAddOptions, RemoteLsOptions, RemotePin, RemotePins };
+//# sourceMappingURL=pin.d.cts.map

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

@@ -0,0 +1,99 @@
+//#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, PinataPin, PinataUploadBuilder, PinataUploadResult };
+//# sourceMappingURL=pinata.d.cts.map

package/dist/cjs/types/type-guards.cjs

@@ -0,0 +1,20 @@
+const require_index = require('../errors/index.cjs');
+
+//#region src/types/type-guards.ts
+/**
+* Check if error is retryable.
+*/
+function isRetryable(error) {
+	return error.retryable;
+}
+/**
+* Check if error is authentication-related.
+*/
+function isAuthenticationError(error) {
+	return error instanceof require_index.PinnerError && error.code === "AUTHENTICATION_ERROR";
+}
+
+//#endregion
+exports.isAuthenticationError = isAuthenticationError;
+exports.isRetryable = isRetryable;
+//# sourceMappingURL=type-guards.cjs.map

package/dist/cjs/types/type-guards.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.cjs","names":["PinnerError"],"sources":["../../../src/types/type-guards.ts"],"sourcesContent":["import { PinnerError } from \"../errors\";\n\n/**\n * Check if error is retryable.\n */\nexport function isRetryable(error: PinnerError): boolean {\n  return error.retryable;\n}\n\n/**\n * Check if error is authentication-related.\n */\nexport function isAuthenticationError(error: PinnerError): boolean {\n  return error instanceof PinnerError && error.code === \"AUTHENTICATION_ERROR\";\n}\n"],"mappings":";;;;;;AAKA,SAAgB,YAAY,OAA6B;AACvD,QAAO,MAAM;;;;;AAMf,SAAgB,sBAAsB,OAA6B;AACjE,QAAO,iBAAiBA,6BAAe,MAAM,SAAS"}

package/dist/cjs/types/type-guards.d.cts

@@ -0,0 +1,15 @@
+import { PinnerError } from "../errors/index.cjs";
+
+//#region src/types/type-guards.d.ts
+
+/**
+ * Check if error is retryable.
+ */
+declare function isRetryable(error: PinnerError): boolean;
+/**
+ * Check if error is authentication-related.
+ */
+declare function isAuthenticationError(error: PinnerError): boolean;
+//#endregion
+export { isAuthenticationError, isRetryable };
+//# sourceMappingURL=type-guards.d.cts.map

package/dist/cjs/types/upload.cjs

@@ -0,0 +1,18 @@
+
+//#region src/types/upload.ts
+/**
+* Symbol used to brand UploadResult for type checking
+*/
+const UploadResultSymbol = Symbol("UploadResult");
+/**
+* Type guard to check if a value is an UploadResult
+* Uses the UploadResultSymbol for reliable type checking
+*/
+function isUploadResult(value) {
+	return typeof value === "object" && value !== null && UploadResultSymbol in value && value[UploadResultSymbol] === true;
+}
+
+//#endregion
+exports.UploadResultSymbol = UploadResultSymbol;
+exports.isUploadResult = isUploadResult;
+//# sourceMappingURL=upload.cjs.map

package/dist/cjs/types/upload.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.cjs","names":[],"sources":["../../../src/types/upload.ts"],"sourcesContent":["import type { OperationPollingOptions } from \"@lumeweb/portal-sdk\";\n\n/**\n * Symbol used to brand UploadResult for type checking\n */\nexport const UploadResultSymbol = Symbol(\"UploadResult\");\n\nexport interface UploadResult {\n  /**\n   * Unique identifier for this upload operation.\n   */\n  id: string;\n\n  /**\n   * IPFS Content Identifier for the uploaded content.\n   */\n  cid: string;\n\n  /**\n   * User-provided or auto-generated name for the content.\n   */\n  name: string;\n\n  /**\n   * Total size in bytes.\n   */\n  size: number;\n\n  /**\n   * MIME type of the content.\n   */\n  mimeType: string;\n\n  /**\n   * ISO timestamp when content was created.\n   */\n  createdAt: Date;\n\n  /**\n   * Number of files (1 for single file, N for directory).\n   */\n  numberOfFiles: number;\n\n  /**\n   * Custom key-value metadata.\n   */\n  keyvalues?: Record<string, string>;\n\n  /**\n   * Whether this upload is a directory.\n   */\n  isDirectory?: boolean;\n\n  /**\n   * Whether this upload is already a valid CAR file.\n   * If true, the upload system will skip CAR preprocessing and upload the file as-is.\n   * Useful for passthrough of pre-generated CAR files.\n   */\n  isCarFile?: boolean;\n\n  /**\n   * Portal operation ID for tracking the pinning operation.\n   * Can be used with waitForOperation() to wait for the operation to complete.\n   */\n  operationId?: number;\n\n  /**\n   * Symbol brand for type checking - used to identify UploadResult objects\n   */\n  [UploadResultSymbol]?: true;\n}\n\nexport type UploadInput = File | ReadableStream<Uint8Array>;\n\n/**\n * Type guard to check if a value is an UploadResult\n * Uses the UploadResultSymbol for reliable type checking\n */\nexport function isUploadResult(value: unknown): value is UploadResult {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    UploadResultSymbol in value &&\n    value[UploadResultSymbol] === true\n  );\n}\n\nexport interface UploadOptions {\n  /**\n   * Name for the uploaded content.\n   */\n  name?: string;\n\n  /**\n   * Custom key-value metadata.\n   */\n  keyvalues?: Record<string, string>;\n\n  /**\n   * Progress callback invoked during upload.\n   */\n  onProgress?: (progress: UploadProgress) => void;\n\n  /**\n   * Callback invoked when upload completes successfully.\n   */\n  onComplete?: (result: UploadResult) => void;\n\n  /**\n   * Callback invoked when upload fails.\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * AbortSignal for cancellation.\n   */\n  signal?: AbortSignal;\n\n  /**\n   * Optional size override for the upload input.\n   * Useful for ReadableStream inputs where size detection is difficult.\n   */\n  size?: number;\n\n  /**\n   * Whether this upload is a directory.\n   */\n  isDirectory?: boolean;\n\n  /**\n   * Whether this upload is already a valid CAR file.\n   * If true, the upload system will skip CAR preprocessing and upload the file as-is.\n   * Useful for passthrough of pre-generated CAR files.\n   */\n  isCarFile?: boolean;\n\n  /**\n   * Whether to wait for the pinning operation to complete/fail.\n   * When true, the upload will block until the operation reaches a settled state\n   * (completed, failed, or error). Default is false (upload only).\n   */\n  waitForOperation?: boolean;\n\n  /**\n   * Polling options for waiting on operation completion.\n   * Only used when waitForOperation is true.\n   */\n  operationPollingOptions?: OperationPollingOptions;\n}\n\nexport interface UploadProgress {\n  /**\n   * Percentage complete (0-100).\n   */\n  percentage: number;\n\n  /**\n   * Number of bytes uploaded.\n   */\n  bytesUploaded: number;\n\n  /**\n   * Total bytes to upload.\n   */\n  bytesTotal: number;\n\n  /**\n   * Upload speed in bytes per second.\n   */\n  speed?: number;\n\n  /**\n   * Estimated time remaining in seconds.\n   */\n  eta?: number;\n}\n\nexport interface UploadOperation {\n  /**\n   * Cancel the ongoing upload.\n   */\n  cancel(): void;\n\n  /**\n   * Pause the upload (TUS only).\n   */\n  pause(): void;\n\n  /**\n   * Resume a paused upload (TUS only).\n   */\n  resume(): void;\n\n  /**\n   * Promise that resolves when upload completes.\n   */\n  result: Promise<UploadResult>;\n\n  /**\n   * Current progress.\n   */\n  progress: Readonly<UploadProgress>;\n}\n\n/**\n * Builder interface for Pinner upload API.\n * Supports chaining name/keyvalues and returns UploadOperation with controls.\n */\nexport interface PinnerUploadBuilder {\n  /**\n   * Set the name for the upload.\n   */\n  name(name: string): this;\n\n  /**\n   * Set custom key-value metadata.\n   */\n  keyvalues(kv: Record<string, string>): this;\n\n  /**\n   * Whether to wait for the pinning operation to complete/fail.\n   * When true, the upload will block until the operation reaches a settled state.\n   */\n  waitForOperation(wait: boolean): this;\n\n  /**\n   * Set polling options for waiting on operation completion.\n   * Only used when waitForOperation is true.\n   */\n  operationPollingOptions(options: OperationPollingOptions): this;\n\n  /**\n   * Start the upload and return UploadOperation with controls.\n   */\n  pin(): Promise<UploadOperation>;\n}\n"],"mappings":";;;;;AAKA,MAAa,qBAAqB,OAAO,eAAe;;;;;AAyExD,SAAgB,eAAe,OAAuC;AACpE,QACE,OAAO,UAAU,YACjB,UAAU,QACV,sBAAsB,SACtB,MAAM,wBAAwB"}