@lumeweb/pinner 0.1.0 → 0.1.1

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

@@ -0,0 +1,3 @@
+import { AccessLinkOptions, AnalyticsQuery, CidVersion, DeleteResponse, FileListItem, FileListResponse, GetGroupOptions, GroupCIDOptions, GroupListResponse, GroupOptions, GroupResponseItem, PinByCIDResponse, PinQueueItem, PinQueueResponse, PinataConfig, PinataMetadata, SignedUploadUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TimePeriodItem, TopAnalyticsItem, TopAnalyticsQuery, TopAnalyticsResponse, UpdateFileOptions, UpdateGroupFilesResponse, UpdateGroupOptions, UploadCIDOptions, UploadOptions, UploadResponse } from "./types.js";
+import { PinataAdapter } from "./adapter-interface.js";
+import { pinataAdapter } from "./adapter.js";

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

@@ -0,0 +1 @@
+import { pinataAdapter } from "./adapter.js";

package/dist/esm/adapters/pinata/v2/types.d.ts

@@ -0,0 +1,308 @@
+//#region src/adapters/pinata/v2/types.d.ts
+/**
+ * Pinata SDK 2.x Types
+ * Source: https://github.com/PinataCloud/pinata/commit/cdc0c06116aaadaf7c4b287a2673cd23b6ba1125
+ * - src/core/types/index.ts
+ *
+ * Copyright © 2024 Pinata Cloud Technologies
+ * Type definitions adapted from Pinata SDK for compatibility.
+ * Original Pinata SDK: https://github.com/PinataCloud/pinata
+ */
+/**
+ * CID version type
+ */
+type CidVersion = "v0" | "v1";
+/**
+ * Pinata configuration options
+ */
+type PinataConfig = {
+  pinataJwt?: string;
+  pinataGateway?: string;
+  pinataGatewayKey?: string;
+  customHeaders?: Record<string, string>;
+  endpointUrl?: string;
+  uploadUrl?: string;
+  legacyUploadUrl?: string;
+};
+/**
+ * Pinata metadata
+ */
+type PinataMetadata = {
+  name?: string;
+  keyvalues?: Record<string, string>;
+};
+/**
+ * Upload options
+ */
+type UploadOptions = {
+  metadata?: PinataMetadata;
+  keys?: string;
+  groupId?: string;
+  vectorize?: boolean;
+  url?: string;
+  streamable?: boolean;
+  peerAddresses?: string[];
+  car?: boolean;
+  cid_version?: CidVersion;
+};
+/**
+ * Upload response
+ */
+type UploadResponse = {
+  id: string;
+  name: string;
+  cid: string;
+  size: number;
+  created_at: string;
+  number_of_files: number;
+  mime_type: string;
+  group_id: string | null;
+  keyvalues: Record<string, string>;
+  vectorized: boolean;
+  network: string;
+};
+/**
+ * Upload CID options
+ */
+type UploadCIDOptions = {
+  metadata?: PinataMetadata;
+  peerAddresses?: string[];
+  keys?: string;
+  groupId?: string;
+};
+/**
+ * Pin by CID response
+ */
+type PinByCIDResponse = {
+  id: string;
+  cid: string;
+  date_queued: string;
+  name: string;
+  status: string;
+  keyvalues: Record<string, any> | null;
+  host_nodes: string[] | null;
+  group_id: string | null;
+};
+/**
+ * Signed upload URL options
+ */
+type SignedUploadUrlOptions = {
+  date?: number;
+  expires: number;
+  groupId?: string;
+  name?: string;
+  keyvalues?: Record<string, string>;
+  vectorize?: boolean;
+  maxFileSize?: number;
+  mimeTypes?: string[];
+  streamable?: boolean;
+  car?: boolean;
+  cid_version?: CidVersion;
+};
+/**
+ * File list item
+ */
+type FileListItem = {
+  id: string;
+  name: string | null;
+  cid: "pending" | string;
+  size: number;
+  number_of_files: number;
+  mime_type: string;
+  keyvalues: Record<string, string>;
+  group_id: string | null;
+  created_at: string;
+};
+/**
+ * File list response
+ */
+type FileListResponse = {
+  files: FileListItem[];
+  next_page_token: string;
+};
+/**
+ * Update file options
+ */
+type UpdateFileOptions = {
+  id: string;
+  name?: string;
+  keyvalues?: Record<string, string>;
+};
+/**
+ * Delete response
+ */
+type DeleteResponse = {
+  id: string;
+  status: string;
+};
+/**
+ * Pin queue item
+ */
+type PinQueueItem = {
+  id: string;
+  cid?: string;
+  ipfs_pin_hash?: string;
+  date_queued: string;
+  name: string;
+  status: string;
+  keyvalues: any;
+  host_nodes: string[];
+  pin_policy: {
+    regions: {
+      id: string;
+      desiredReplicationCount: number;
+    }[];
+    version: number;
+  };
+};
+/**
+ * Pin queue response
+ */
+type PinQueueResponse = {
+  jobs: PinQueueItem[];
+  next_page_token: string;
+};
+/**
+ * Swap CID options
+ */
+type SwapCidOptions = {
+  cid: string;
+  swapCid: string;
+};
+/**
+ * Swap history options
+ */
+type SwapHistoryOptions = {
+  cid: string;
+  domain: string;
+};
+/**
+ * Swap CID response
+ */
+type SwapCidResponse = {
+  mapped_cid: string;
+  created_at: string;
+};
+/**
+ * Access link options
+ */
+type AccessLinkOptions = {
+  cid: string;
+  date?: number;
+  expires: number;
+  gateway?: string;
+};
+/**
+ * Group options
+ */
+type GroupOptions = {
+  name: string;
+  isPublic?: boolean;
+};
+/**
+ * Update group options
+ */
+type UpdateGroupOptions = {
+  groupId: string;
+  name?: string;
+  isPublic?: boolean;
+};
+/**
+ * Get group options
+ */
+type GetGroupOptions = {
+  groupId: string;
+};
+/**
+ * Group response item
+ */
+type GroupResponseItem = {
+  id: string;
+  is_public: boolean;
+  name: string;
+  createdAt: string;
+};
+/**
+ * Group list response
+ */
+type GroupListResponse = {
+  groups: GroupResponseItem[];
+  next_page_token: string;
+};
+/**
+ * Group CID options
+ */
+type GroupCIDOptions = {
+  groupId: string;
+  files: string[];
+};
+/**
+ * Update group files response
+ */
+type UpdateGroupFilesResponse = {
+  id: string;
+  status: string;
+};
+/**
+ * Analytics query
+ */
+type AnalyticsQuery = {
+  gateway_domain: string;
+  start_date: string;
+  end_date: string;
+  cid?: string;
+  file_name?: string;
+  user_agent?: string;
+  country?: string;
+  region?: string;
+  referer?: string;
+  limit?: number;
+  sort_order?: "asc" | "desc";
+};
+/**
+ * Top analytics query
+ */
+type TopAnalyticsQuery = AnalyticsQuery & {
+  sort_by: "requests" | "bandwidth";
+  attribute: "cid" | "country" | "region" | "user_agent" | "referer" | "file_name";
+};
+/**
+ * Top analytics response
+ */
+type TopAnalyticsResponse = {
+  data: TopAnalyticsItem[];
+};
+/**
+ * Top analytics item
+ */
+type TopAnalyticsItem = {
+  value: string;
+  requests: number;
+  bandwidth: number;
+};
+/**
+ * Time interval analytics query
+ */
+type TimeIntervalAnalyticsQuery = AnalyticsQuery & {
+  sort_by?: "requests" | "bandwidth";
+  date_interval: "day" | "week";
+};
+/**
+ * Time period item
+ */
+type TimePeriodItem = {
+  period_start_time: string;
+  requests: number;
+  bandwidth: number;
+};
+/**
+ * Time interval analytics response
+ */
+type TimeIntervalAnalyticsResponse = {
+  total_requests: number;
+  total_bandwidth: number;
+  time_periods: TimePeriodItem[];
+};
+//#endregion
+export { AccessLinkOptions, AnalyticsQuery, CidVersion, DeleteResponse, FileListItem, FileListResponse, GetGroupOptions, GroupCIDOptions, GroupListResponse, GroupOptions, GroupResponseItem, PinByCIDResponse, PinQueueItem, PinQueueResponse, PinataConfig, PinataMetadata, SignedUploadUrlOptions, SwapCidOptions, SwapCidResponse, SwapHistoryOptions, TimeIntervalAnalyticsQuery, TimeIntervalAnalyticsResponse, TimePeriodItem, TopAnalyticsItem, TopAnalyticsQuery, TopAnalyticsResponse, UpdateFileOptions, UpdateGroupFilesResponse, UpdateGroupOptions, UploadCIDOptions, UploadOptions, UploadResponse };
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/index.d.ts

@@ -1,6 +1,6 @@
 import { PinnerConfig } from "./config.js";
 import { UploadInput, UploadOperation, UploadOptions, UploadProgress, UploadResult } from "./types/upload.js";
-import { RemoteAddOptions, RemoteLsOptions, RemotePin, RemotePins } from "./types/pin.js";
+import { AbortOptions, RemoteAddOptions, RemoteLsOptions, RemotePin, RemotePins } from "./types/pin.js";
 import { Pinner } from "./pinner.js";
 import { UploadManager } from "./upload/manager.js";
 import { CarPreprocessOptions, CarPreprocessResult, destroyCarPreprocessor, isCarFile, preprocessToCar } from "./upload/car.js";
@@ -11,6 +11,8 @@ import { UnstorageBlockstoreOptions, setDriverFactory } from "./blockstore/unsto
 import { createBlockstore, createDatastore } from "./blockstore/unstorage.js";
 import "./blockstore/index.js";
 import { asyncGeneratorToReadableStream, calculateStreamSize, readableStreamToAsyncIterable, streamToBlob } from "./utils/stream.js";
-import { pinataAdapter } from "./adapters/pinata/adapter.js";
+import { PinataAdapter } from "./adapters/pinata/v2/adapter-interface.js";
+import { pinataAdapter } from "./adapters/pinata/v2/adapter.js";
+import { PinataLegacyAdapter, pinataLegacyAdapter } from "./adapters/pinata/legacy/adapter.js";
 import "./adapters/pinata/index.js";
-export { AuthenticationError, type CarPreprocessOptions, type CarPreprocessResult, ConfigurationError, EmptyFileError, FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM, NetworkError, NotFoundError, PinError, Pinner, type PinnerConfig, PinnerError, RateLimitError, type RemoteAddOptions, type RemoteLsOptions, type RemotePin, type RemotePins, TimeoutError, type UnstorageBlockstoreOptions, UploadError, type UploadInput, UploadManager, type UploadOperation, type UploadOptions, type UploadProgress, type UploadResult, ValidationError, asyncGeneratorToReadableStream, calculateStreamSize, createBlockstore, createDatastore, destroyCarPreprocessor, isAuthenticationError, isCarFile, isRetryable, pinataAdapter, preprocessToCar, readableStreamToAsyncIterable, setDriverFactory, streamToBlob };
+export { type AbortOptions, AuthenticationError, type CarPreprocessOptions, type CarPreprocessResult, ConfigurationError, EmptyFileError, FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM, NetworkError, NotFoundError, PinError, type PinataAdapter, type PinataLegacyAdapter, Pinner, type PinnerConfig, PinnerError, RateLimitError, type RemoteAddOptions, type RemoteLsOptions, type RemotePin, type RemotePins, TimeoutError, type UnstorageBlockstoreOptions, UploadError, type UploadInput, UploadManager, type UploadOperation, type UploadOptions, type UploadProgress, type UploadResult, ValidationError, asyncGeneratorToReadableStream, calculateStreamSize, createBlockstore, createDatastore, destroyCarPreprocessor, isAuthenticationError, isCarFile, isRetryable, pinataAdapter, pinataLegacyAdapter, preprocessToCar, readableStreamToAsyncIterable, setDriverFactory, streamToBlob };

package/dist/esm/index.js

@@ -8,7 +8,8 @@ import { AuthenticationError, ConfigurationError, EmptyFileError, NetworkError,
 import { UploadManager } from "./upload/manager.js";
 import { Pinner } from "./pinner.js";
 import { isAuthenticationError, isRetryable } from "./types/type-guards.js";
-import { pinataAdapter } from "./adapters/pinata/adapter.js";
+import { pinataAdapter } from "./adapters/pinata/v2/adapter.js";
+import { pinataLegacyAdapter } from "./adapters/pinata/legacy/adapter.js";
 import "./adapters/pinata/index.js";
 
-export { AuthenticationError, ConfigurationError, EmptyFileError, FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM, NetworkError, NotFoundError, PinError, Pinner, PinnerError, RateLimitError, TimeoutError, UploadError, UploadManager, ValidationError, asyncGeneratorToReadableStream, calculateStreamSize, createBlockstore, createDatastore, destroyCarPreprocessor, isAuthenticationError, isCarFile, isRetryable, pinataAdapter, preprocessToCar, readableStreamToAsyncIterable, setDriverFactory, streamToBlob };
+export { AuthenticationError, ConfigurationError, EmptyFileError, FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM, NetworkError, NotFoundError, PinError, Pinner, PinnerError, RateLimitError, TimeoutError, UploadError, UploadManager, ValidationError, asyncGeneratorToReadableStream, calculateStreamSize, createBlockstore, createDatastore, destroyCarPreprocessor, isAuthenticationError, isCarFile, isRetryable, pinataAdapter, pinataLegacyAdapter, preprocessToCar, readableStreamToAsyncIterable, setDriverFactory, streamToBlob };

package/dist/esm/pin/client.js

@@ -63,13 +63,15 @@ var PinClient = class {
 		}, { signal: options?.signal });
 	}
 	async *rm(cid, options) {
-		const client = this.getClient();
-		const response = await client.pinsGet({ cid: [cid.toString()] }, { signal: options?.signal });
+		const response = await this.getClient().pinsGet({ cid: [cid.toString()] }, { signal: options?.signal });
 		await Promise.all([...response.results].map(async (result) => {
-			return client.pinsRequestidDelete({ requestid: result.requestid }, { signal: options?.signal });
+			return this.rmByRequestId(result.requestid, options);
 		}));
 		yield cid;
 	}
+	async rmByRequestId(requestId, options) {
+		await this.getClient().pinsRequestidDelete({ requestid: requestId }, { signal: options?.signal });
+	}
 	mapResponse(response) {
 		return {
 			cid: CID.parse(response.pin.cid),

package/dist/esm/pin/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"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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"}
+{"version":3,"file":"client.js","names":[],"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    // Delete all pins for this CID by their request IDs\n    await Promise.all(\n      [...response.results].map(async (result) => {\n        return this.rmByRequestId(result.requestid, options);\n      }),\n    );\n\n    yield cid;\n  }\n\n  async rmByRequestId(requestId: string, options?: AbortOptions): Promise<void> {\n    const client = this.getClient();\n    await client.pinsRequestidDelete(\n      { requestid: requestId },\n      { signal: options?.signal },\n    );\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":";;;;;AAiBA,IAAa,YAAb,MAA6C;CAC3C,AAAQ,SAA4C;CACpD,AAAQ;CAER,YAAY,QAAsB;AAChC,OAAK,SAAS;;CAGhB,AAAU,YAAwC;AAChD,MAAI,KAAK,OACP,QAAO,KAAK;AAGd,MAAI,CAAC,KAAK,OAAO,IACf,OAAM,IAAI,mBAAmB,wBAAwB;AASvD,OAAK,SAAS,IAAI,2BANI,IAAI,cAAc;GACtC,aAAa,KAAK,OAAO;GACzB,aAAa,KAAK,OAAO;GACzB,UAAU,KAAK,OAAO,SAAS;GAChC,CAAC,CAEyD;AAC3D,SAAO,KAAK;;CAGd,OAAO,IACL,KACA,SACsC;EACtC,MAAM,SAAS,KAAK,WAAW;EAE/B,MAAM,MAAW;GACf,KAAK,IAAI,UAAU;GACnB,MAAM,SAAS;GACf,MAAM,SAAS;GACf,SAAS,SAAS;GACnB;AAED,QAAM,OAAO,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,SAAS,QAAQ,CAAC;AAE3D,QAAM;;CAGR,OAAO,GACL,SAC4C;EAE5C,MAAM,WAAW,MADF,KAAK,WAAW,CACD,QAAQ,KAAK,qBAAqB,QAAQ,EAAE,EACxE,QAAQ,SAAS,QAClB,CAAC;AAEF,OAAK,MAAM,UAAU,SAAS,QAC5B,OAAM,KAAK,YAAY,OAAO;;CAIlC,MAAM,SAAS,KAAU,SAA0C;AACjE,MAAI;AACF,SAAM,KAAK,IAAI,KAAK,QAAQ;AAC5B,UAAO;UACD;AACN,UAAO;;;CAIX,MAAM,IAAI,KAAU,SAA4C;EAE9D,MAAM,WAAW,MADF,KAAK,WAAW,CACD,QAC5B,EAAE,KAAK,CAAC,IAAI,UAAU,CAAC,EAAE,EACzB,EACE,QAAQ,SAAS,QAClB,CACF;AAED,MAAI,SAAS,QAAQ,WAAW,EAC9B,OAAM,IAAI,cAAc,0BAA0B,IAAI,UAAU,GAAG;AAGrE,SAAO,KAAK,YAAY,SAAS,QAAQ,GAAG;;CAG9C,MAAM,YACJ,KACA,UACA,SACe;EACf,MAAM,SAAS,KAAK,WAAW;EAC/B,MAAM,WAAW,MAAM,OAAO,QAC5B,EAAE,KAAK,CAAC,IAAI,UAAU,CAAC,EAAE,EACzB,EACE,QAAQ,SAAS,QAClB,CACF;AAED,MAAI,SAAS,QAAQ,WAAW,EAC9B,OAAM,IAAI,cAAc,0BAA0B,IAAI,UAAU,GAAG;EAGrE,MAAM,MAAM,SAAS,QAAQ;AAC7B,QAAM,OAAO,kBACX;GACE,WAAW,IAAI;GACf,KAAK;IACH,KAAK,IAAI,IAAI;IACb,MAAM,IAAI,IAAI;IACd,MAAM;IACN,SAAS,IAAI,IAAI;IAClB;GACF,EACD,EAAE,QAAQ,SAAS,QAAQ,CAC5B;;CAGH,OAAO,GACL,KACA,SACsC;EAEtC,MAAM,WAAW,MADF,KAAK,WAAW,CACD,QAC5B,EAAE,KAAK,CAAC,IAAI,UAAU,CAAC,EAAE,EACzB,EAAE,QAAQ,SAAS,QAAQ,CAC5B;AAGD,QAAM,QAAQ,IACZ,CAAC,GAAG,SAAS,QAAQ,CAAC,IAAI,OAAO,WAAW;AAC1C,UAAO,KAAK,cAAc,OAAO,WAAW,QAAQ;IACpD,CACH;AAED,QAAM;;CAGR,MAAM,cAAc,WAAmB,SAAuC;AAE5E,QADe,KAAK,WAAW,CAClB,oBACX,EAAE,WAAW,WAAW,EACxB,EAAE,QAAQ,SAAS,QAAQ,CAC5B;;CAGH,AAAQ,YAAY,UAAgC;AAClD,SAAO;GACL,KAAK,IAAI,MAAM,SAAS,IAAI,IAAI;GAChC,MAAM,SAAS,IAAI;GACnB,QAAQ,SAAS;GACjB,SAAS,SAAS;GAClB,MAAM,SAAS,IAAI,MAAM,OACrB,SAAS,SAAS,IAAI,KAAK,MAAM,GAAG,GACpC;GACJ,UAAU,SAAS,IAAI;GACxB;;CAGH,AAAQ,qBACN,SACyB;EACzB,MAAM,UAAmC,EAAE;AAE3C,MAAI,SAAS,UAAU,OACrB,SAAQ,QAAQ,QAAQ;AAE1B,MAAI,SAAS,WAAW,OACtB,SAAQ,QAAQ,QAAQ;AAE1B,MAAI,SAAS,WAAW,OACtB,SAAQ,SAAS,QAAQ;AAE3B,MAAI,SAAS,SAAS,OACpB,SAAQ,OAAO,QAAQ;AAGzB,SAAO"}

package/dist/esm/pinner.d.ts

@@ -67,6 +67,10 @@ declare class Pinner {
    * Remove a pin. The block may be deleted when garbage collection is run.
    */
   unpin(cid: string | CID, options?: AbortOptions): Promise<void>;
+  /**
+   * Remove a pin by request ID. The block may be deleted when garbage collection is run.
+   */
+  unpinByRequestId(requestId: string, options?: AbortOptions): Promise<void>;
   /**
    * Destroy the client and cleanup resources.
    */

package/dist/esm/pinner.js

@@ -113,6 +113,12 @@ var Pinner = class {
 		for await (const _ of generator);
 	}
 	/**
+	* Remove a pin by request ID. The block may be deleted when garbage collection is run.
+	*/
+	async unpinByRequestId(requestId, options) {
+		return this.pins.rmByRequestId(requestId, options);
+	}
+	/**
 	* Destroy the client and cleanup resources.
 	*/
 	destroy() {

package/dist/esm/pinner.js.map

@@ -1 +1 @@
-{"version":3,"file":"pinner.js","names":[],"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,IAAI,cAAc,OAAO;AAC9C,OAAK,QAAQ,IAAI,UAAU,OAAO;;;;;CAMpC,IAAI,OAAmB;AACrB,SAAO,KAAK;;;;;;;;CASd,IAAI,SAAiC;AACnC,MAAI,CAAC,KAAK,SAAS;GACjB,MAAM,mBAAmB,6BAA6B,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,WAAW,IAAI,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,WAAW,IAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;CAM9B,MAAM,SAAS,KAAqC;EAClD,MAAM,SAAS,OAAO,QAAQ,WAAW,IAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,SAAS,OAAO;;;;;CAMnC,MAAM,eACJ,KACA,UACe;EACf,MAAM,SAAS,OAAO,QAAQ,WAAW,IAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,YAAY,QAAQ,SAAS;;;;;CAMhD,MAAM,MAAM,KAAmB,SAAuC;EACpE,MAAM,SAAS,OAAO,QAAQ,WAAW,IAAI,MAAM,IAAI,GAAG;EAC1D,MAAM,YAAY,KAAK,KAAK,GAAG,QAAQ,QAAQ;AAC/C,aAAW,MAAM,KAAK;;;;;CAQxB,UAAgB;AACd,OAAK,cAAc,SAAS"}
+{"version":3,"file":"pinner.js","names":[],"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   * Remove a pin by request ID. The block may be deleted when garbage collection is run.\n   */\n  async unpinByRequestId(requestId: string, options?: AbortOptions): Promise<void> {\n    return this.pins.rmByRequestId(requestId, options);\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,IAAI,cAAc,OAAO;AAC9C,OAAK,QAAQ,IAAI,UAAU,OAAO;;;;;CAMpC,IAAI,OAAmB;AACrB,SAAO,KAAK;;;;;;;;CASd,IAAI,SAAiC;AACnC,MAAI,CAAC,KAAK,SAAS;GACjB,MAAM,mBAAmB,6BAA6B,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,WAAW,IAAI,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,WAAW,IAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;CAM9B,MAAM,SAAS,KAAqC;EAClD,MAAM,SAAS,OAAO,QAAQ,WAAW,IAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,SAAS,OAAO;;;;;CAMnC,MAAM,eACJ,KACA,UACe;EACf,MAAM,SAAS,OAAO,QAAQ,WAAW,IAAI,MAAM,IAAI,GAAG;AAC1D,SAAO,KAAK,KAAK,YAAY,QAAQ,SAAS;;;;;CAMhD,MAAM,MAAM,KAAmB,SAAuC;EACpE,MAAM,SAAS,OAAO,QAAQ,WAAW,IAAI,MAAM,IAAI,GAAG;EAC1D,MAAM,YAAY,KAAK,KAAK,GAAG,QAAQ,QAAQ;AAC/C,aAAW,MAAM,KAAK;;;;;CAQxB,MAAM,iBAAiB,WAAmB,SAAuC;AAC/E,SAAO,KAAK,KAAK,cAAc,WAAW,QAAQ;;;;;CAMpD,UAAgB;AACd,OAAK,cAAc,SAAS"}

package/dist/esm/types/constants.js

@@ -2,7 +2,11 @@
 /**
 * Default API endpoint URL for the pinning service.
 */
-const DEFAULT_ENDPOINT = "https://api.lumeweb.com";
+const DEFAULT_ENDPOINT = "https://ipfs.pinner.xyz";
+/**
+* Default IPFS gateway URL for content retrieval.
+*/
+const DEFAULT_GATEWAY = "https://dweb.link";
 /**
 * Default TUS upload size threshold (100MB).
 * Files larger than this will use TUS protocol for resumable uploads.
@@ -25,5 +29,5 @@ const DEFAULT_BLOCKSTORE_BASE = "pinner:";
 const DEFAULT_BLOCKSTORE_FS_BASE = "./.pinner-blocks";
 
 //#endregion
-export { DEFAULT_BLOCKSTORE_BASE, DEFAULT_BLOCKSTORE_FS_BASE, DEFAULT_BLOCKSTORE_PREFIX, DEFAULT_ENDPOINT, TUS_SIZE_THRESHOLD };
+export { DEFAULT_BLOCKSTORE_BASE, DEFAULT_BLOCKSTORE_FS_BASE, DEFAULT_BLOCKSTORE_PREFIX, DEFAULT_ENDPOINT, DEFAULT_GATEWAY, TUS_SIZE_THRESHOLD };
 //# sourceMappingURL=constants.js.map

package/dist/esm/types/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","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"}
+{"version":3,"file":"constants.js","names":[],"sources":["../../../src/types/constants.ts"],"sourcesContent":["/**\n * Default API endpoint URL for the pinning service.\n */\nexport const DEFAULT_ENDPOINT = \"https://ipfs.pinner.xyz\";\n\n/**\n * Default IPFS gateway URL for content retrieval.\n */\nexport const DEFAULT_GATEWAY = \"https://dweb.link\";\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;;;;AAKhC,MAAa,kBAAkB;;;;;AAM/B,MAAa,qBAAqB,MAAM,OAAO;;;;;AAW/C,MAAa,4BAA4B;;;;;;AAOzC,MAAa,0BAA0B;;;;AAKvC,MAAa,6BAA6B"}

package/dist/esm/types/pin.d.ts

@@ -68,6 +68,10 @@ interface RemotePins {
    * Remove a pin. The block may be deleted when garbage collection is run.
    */
   rm(cid: CID, options?: AbortOptions): AsyncGenerator<CID, void, undefined>;
+  /**
+   * Remove a pin by request ID. The block may be deleted when garbage collection is run.
+   */
+  rmByRequestId(requestId: string, options?: AbortOptions): Promise<void>;
 }
 //#endregion
 export { AbortOptions, RemoteAddOptions, RemoteLsOptions, RemotePin, RemotePins };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumeweb/pinner",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "files": [
     "dist",
@@ -57,9 +57,9 @@
     "progress-events": "^1.0.1",
     "tus-js-client": "4.3.1",
     "unstorage": "^1.17.3",
-    "@lumeweb/uppy-post-upload": "0.1.0",
     "@lumeweb/portal-sdk": "0.1.0",
-    "@lumeweb/query-builder": "0.1.0"
+    "@lumeweb/query-builder": "0.1.0",
+    "@lumeweb/uppy-post-upload": "0.1.0"
   },
   "devDependencies": {
     "@mswjs/interceptors": "^0.40.0",

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

@@ -1,88 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}