@lumeweb/pinner 0.0.1 → 0.1.0

package/dist/esm/encoder/url.js

@@ -0,0 +1,36 @@
+import { EncoderError } from "./error.js";
+import ky, { isHTTPError, isTimeoutError } from "ky";
+
+//#region src/encoder/url.ts
+/**
+* URL encoder - fetches content from URLs and converts to File objects.
+*/
+var UrlEncoder = class {
+	async encode(urlString, options) {
+		try {
+			const blob = await ky(urlString, { fetch: options?.fetch }).blob();
+			const filename = options?.name || new URL(urlString).pathname.split("/").pop() || "file";
+			return {
+				file: new File([blob], filename, { type: blob.type }),
+				options: {
+					name: options?.name,
+					keyvalues: options?.keyvalues
+				}
+			};
+		} catch (error) {
+			if (isHTTPError(error) || isTimeoutError(error)) throw new EncoderError(`URL encoding failed: ${error.message}`, "NETWORK_ERROR", error);
+			if (error instanceof Error) throw new EncoderError(`URL encoding failed: ${error.message}`, "NETWORK_ERROR", error);
+			throw new EncoderError("URL encoding failed: unknown error", "UNKNOWN");
+		}
+	}
+};
+/**
+* Encode a URL to a File object by fetching the content.
+*/
+async function urlToFile(urlString, options) {
+	return new UrlEncoder().encode(urlString, options);
+}
+
+//#endregion
+export { UrlEncoder, urlToFile };
+//# sourceMappingURL=url.js.map

package/dist/esm/encoder/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","names":[],"sources":["../../../src/encoder/url.ts"],"sourcesContent":["import ky, { isHTTPError, isTimeoutError } from \"ky\";\nimport type { Encoder, EncoderResult, UploadOptions } from \"./types\";\nimport { EncoderError } from \"./error\";\n\n/**\n * URL encoder - fetches content from URLs and converts to File objects.\n */\nexport class UrlEncoder implements Encoder<string> {\n  async encode(\n    urlString: string,\n    options?: UploadOptions,\n  ): Promise<EncoderResult> {\n    try {\n      const blob = await ky(urlString, { fetch: options?.fetch }).blob();\n      const filename =\n        options?.name || new URL(urlString).pathname.split(\"/\").pop() || \"file\";\n      const file = new File([blob], filename, { type: blob.type });\n\n      return {\n        file,\n        options: {\n          name: options?.name,\n          keyvalues: options?.keyvalues,\n        },\n      };\n    } catch (error) {\n      if (isHTTPError(error) || isTimeoutError(error)) {\n        throw new EncoderError(\n          `URL encoding failed: ${error.message}`,\n          \"NETWORK_ERROR\",\n          error,\n        );\n      }\n\n      if (error instanceof Error) {\n        throw new EncoderError(\n          `URL encoding failed: ${error.message}`,\n          \"NETWORK_ERROR\",\n          error,\n        );\n      }\n\n      throw new EncoderError(\"URL encoding failed: unknown error\", \"UNKNOWN\");\n    }\n  }\n}\n\n/**\n * Encode a URL to a File object by fetching the content.\n */\nexport async function urlToFile(\n  urlString: string,\n  options?: UploadOptions,\n): Promise<EncoderResult> {\n  const encoder = new UrlEncoder();\n  return encoder.encode(urlString, options);\n}\n"],"mappings":";;;;;;;AAOA,IAAa,aAAb,MAAmD;CACjD,MAAM,OACJ,WACA,SACwB;AACxB,MAAI;GACF,MAAM,OAAO,MAAM,GAAG,WAAW,EAAE,OAAO,SAAS,OAAO,CAAC,CAAC,MAAM;GAClE,MAAM,WACJ,SAAS,QAAQ,IAAI,IAAI,UAAU,CAAC,SAAS,MAAM,IAAI,CAAC,KAAK,IAAI;AAGnE,UAAO;IACL,MAHW,IAAI,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAI1D,SAAS;KACP,MAAM,SAAS;KACf,WAAW,SAAS;KACrB;IACF;WACM,OAAO;AACd,OAAI,YAAY,MAAM,IAAI,eAAe,MAAM,CAC7C,OAAM,IAAI,aACR,wBAAwB,MAAM,WAC9B,iBACA,MACD;AAGH,OAAI,iBAAiB,MACnB,OAAM,IAAI,aACR,wBAAwB,MAAM,WAC9B,iBACA,MACD;AAGH,SAAM,IAAI,aAAa,sCAAsC,UAAU;;;;;;;AAQ7E,eAAsB,UACpB,WACA,SACwB;AAExB,QADgB,IAAI,YAAY,CACjB,OAAO,WAAW,QAAQ"}

package/dist/esm/errors/index.d.ts

@@ -0,0 +1,47 @@
+//#region src/errors/index.d.ts
+declare class PinnerError extends Error {
+  code: string;
+  retryable: boolean;
+  cause?: Error | undefined;
+  constructor(code: string, message: string, retryable: boolean, cause?: Error | undefined);
+}
+declare class ConfigurationError extends PinnerError {
+  constructor(message: string, cause?: Error);
+}
+declare class AuthenticationError extends PinnerError {
+  constructor(message?: string, cause?: Error);
+}
+declare class UploadError extends PinnerError {
+  retryable: boolean;
+  code: string;
+  constructor(message: string, retryable?: boolean, cause?: Error);
+}
+declare class NetworkError extends UploadError {
+  constructor(message?: string, cause?: Error);
+}
+declare class ValidationError extends UploadError {
+  field?: string | undefined;
+  constructor(message: string, field?: string | undefined, cause?: Error);
+}
+declare class EmptyFileError extends ValidationError {
+  constructor(message?: string, cause?: Error);
+}
+declare class TimeoutError extends UploadError {
+  constructor(message?: string, cause?: Error);
+}
+declare class PinError extends PinnerError {
+  constructor(message?: string, retryable?: boolean, cause?: Error);
+}
+declare class NotFoundError extends PinError {
+  constructor(message?: string, cause?: Error);
+}
+declare class RateLimitError extends PinError {
+  /**
+   * Seconds to wait before retry.
+   */
+  retryAfter?: number;
+  constructor(message?: string, retryAfter?: number, cause?: Error);
+}
+//#endregion
+export { AuthenticationError, ConfigurationError, EmptyFileError, NetworkError, NotFoundError, PinError, PinnerError, RateLimitError, TimeoutError, UploadError, ValidationError };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/errors/index.js

@@ -0,0 +1,93 @@
+//#region src/errors/index.ts
+var PinnerError = class extends Error {
+	constructor(code, message, retryable, cause) {
+		super(message);
+		this.code = code;
+		this.retryable = retryable;
+		this.cause = cause;
+		this.name = "PinnerError";
+	}
+};
+var ConfigurationError = class extends PinnerError {
+	constructor(message, cause) {
+		super("CONFIGURATION_ERROR", message, false, cause);
+		this.name = "ConfigurationError";
+	}
+};
+var AuthenticationError = class extends PinnerError {
+	constructor(message = "Authentication failed", cause) {
+		super("AUTHENTICATION_ERROR", message, false, cause);
+		this.name = "AuthenticationError";
+	}
+};
+var UploadError = class extends PinnerError {
+	code = "UPLOAD_ERROR";
+	constructor(message, retryable = false, cause) {
+		super("UPLOAD_ERROR", message, retryable, cause);
+		this.retryable = retryable;
+		this.name = "UploadError";
+	}
+};
+var NetworkError = class extends UploadError {
+	constructor(message = "Network request failed", cause) {
+		super(message, true, cause);
+		this.name = "NetworkError";
+		this.code = "NETWORK_ERROR";
+		this.retryable = true;
+	}
+};
+var ValidationError = class extends UploadError {
+	constructor(message, field, cause) {
+		super(message, false, cause);
+		this.field = field;
+		this.name = "ValidationError";
+		this.code = "VALIDATION_ERROR";
+		this.retryable = false;
+	}
+};
+var EmptyFileError = class extends ValidationError {
+	constructor(message = "Cannot upload empty file", cause) {
+		super(message, "file", cause);
+		this.name = "EmptyFileError";
+		this.code = "EMPTY_FILE_ERROR";
+	}
+};
+var TimeoutError = class extends UploadError {
+	constructor(message = "Request timed out", cause) {
+		super(message, true, cause);
+		this.name = "TimeoutError";
+		this.code = "TIMEOUT_ERROR";
+		this.retryable = true;
+	}
+};
+var PinError = class extends PinnerError {
+	constructor(message = "Pin operation failed", retryable = false, cause) {
+		super("PIN_ERROR", message, retryable, cause);
+		this.name = "PinError";
+	}
+};
+var NotFoundError = class extends PinError {
+	constructor(message = "Resource not found", cause) {
+		super(message, false, cause);
+		this.name = "NotFoundError";
+		this.code = "NOT_FOUND";
+		this.retryable = false;
+	}
+};
+var RateLimitError = class extends PinError {
+	/**
+	* Seconds to wait before retry.
+	*/
+	retryAfter;
+	constructor(message = "Rate limit exceeded", retryAfter, cause) {
+		super(message, true, cause);
+		this.name = "RateLimitError";
+		this.code = "RATE_LIMIT_EXCEEDED";
+		this.retryable = true;
+		this.retryAfter = retryAfter;
+	}
+};
+
+//#endregion
+export { AuthenticationError, ConfigurationError, EmptyFileError, NetworkError, NotFoundError, PinError, PinnerError, RateLimitError, TimeoutError, UploadError, ValidationError };
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/errors/index.ts"],"sourcesContent":["export class PinnerError extends Error {\n  constructor(\n    public code: string,\n    message: string,\n    public retryable: boolean,\n    public cause?: Error\n  ) {\n    super(message);\n    this.name = \"PinnerError\";\n  }\n}\n\nexport class ConfigurationError extends PinnerError {\n  constructor(message: string, cause?: Error) {\n    super(\"CONFIGURATION_ERROR\", message, false, cause);\n    this.name = \"ConfigurationError\";\n  }\n}\n\nexport class AuthenticationError extends PinnerError {\n  constructor(message: string = \"Authentication failed\", cause?: Error) {\n    super(\"AUTHENTICATION_ERROR\", message, false, cause);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class UploadError extends PinnerError {\n  code = \"UPLOAD_ERROR\";\n\n  constructor(\n    message: string,\n    public override retryable: boolean = false,\n    cause?: Error\n  ) {\n    super(\"UPLOAD_ERROR\", message, retryable, cause);\n    this.name = \"UploadError\";\n  }\n}\n\nexport class NetworkError extends UploadError {\n  constructor(message: string = \"Network request failed\", cause?: Error) {\n    super(message, true, cause);\n    this.name = \"NetworkError\";\n    this.code = \"NETWORK_ERROR\";\n    this.retryable = true;\n  }\n}\n\nexport class ValidationError extends UploadError {\n  constructor(message: string, public field?: string, cause?: Error) {\n    super(message, false, cause);\n    this.name = \"ValidationError\";\n    this.code = \"VALIDATION_ERROR\";\n    this.retryable = false;\n  }\n}\n\nexport class EmptyFileError extends ValidationError {\n  constructor(message: string = \"Cannot upload empty file\", cause?: Error) {\n    super(message, \"file\", cause);\n    this.name = \"EmptyFileError\";\n    this.code = \"EMPTY_FILE_ERROR\";\n  }\n}\n\nexport class TimeoutError extends UploadError {\n  constructor(message: string = \"Request timed out\", cause?: Error) {\n    super(message, true, cause);\n    this.name = \"TimeoutError\";\n    this.code = \"TIMEOUT_ERROR\";\n    this.retryable = true;\n  }\n}\n\nexport class PinError extends PinnerError {\n  constructor(message: string = \"Pin operation failed\", retryable: boolean = false, cause?: Error) {\n    super(\"PIN_ERROR\", message, retryable, cause);\n    this.name = \"PinError\";\n  }\n}\n\nexport class NotFoundError extends PinError {\n  constructor(message: string = \"Resource not found\", cause?: Error) {\n    super(message, false, cause);\n    this.name = \"NotFoundError\";\n    this.code = \"NOT_FOUND\";\n    this.retryable = false;\n  }\n}\n\nexport class RateLimitError extends PinError {\n  /**\n   * Seconds to wait before retry.\n   */\n  retryAfter?: number;\n\n  constructor(message: string = \"Rate limit exceeded\", retryAfter?: number, cause?: Error) {\n    super(message, true, cause);\n    this.name = \"RateLimitError\";\n    this.code = \"RATE_LIMIT_EXCEEDED\";\n    this.retryable = true;\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class EnvironmentError extends PinnerError {\n  constructor(message: string = \"Unsupported environment\", cause?: Error) {\n    super(\"ENVIRONMENT_ERROR\", message, false, cause);\n    this.name = \"EnvironmentError\";\n  }\n}"],"mappings":";AAAA,IAAa,cAAb,cAAiC,MAAM;CACrC,YACE,AAAO,MACP,SACA,AAAO,WACP,AAAO,OACP;AACA,QAAM,QAAQ;EALP;EAEA;EACA;AAGP,OAAK,OAAO;;;AAIhB,IAAa,qBAAb,cAAwC,YAAY;CAClD,YAAY,SAAiB,OAAe;AAC1C,QAAM,uBAAuB,SAAS,OAAO,MAAM;AACnD,OAAK,OAAO;;;AAIhB,IAAa,sBAAb,cAAyC,YAAY;CACnD,YAAY,UAAkB,yBAAyB,OAAe;AACpE,QAAM,wBAAwB,SAAS,OAAO,MAAM;AACpD,OAAK,OAAO;;;AAIhB,IAAa,cAAb,cAAiC,YAAY;CAC3C,OAAO;CAEP,YACE,SACA,AAAgB,YAAqB,OACrC,OACA;AACA,QAAM,gBAAgB,SAAS,WAAW,MAAM;EAHhC;AAIhB,OAAK,OAAO;;;AAIhB,IAAa,eAAb,cAAkC,YAAY;CAC5C,YAAY,UAAkB,0BAA0B,OAAe;AACrE,QAAM,SAAS,MAAM,MAAM;AAC3B,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,YAAY;;;AAIrB,IAAa,kBAAb,cAAqC,YAAY;CAC/C,YAAY,SAAiB,AAAO,OAAgB,OAAe;AACjE,QAAM,SAAS,OAAO,MAAM;EADM;AAElC,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,YAAY;;;AAIrB,IAAa,iBAAb,cAAoC,gBAAgB;CAClD,YAAY,UAAkB,4BAA4B,OAAe;AACvE,QAAM,SAAS,QAAQ,MAAM;AAC7B,OAAK,OAAO;AACZ,OAAK,OAAO;;;AAIhB,IAAa,eAAb,cAAkC,YAAY;CAC5C,YAAY,UAAkB,qBAAqB,OAAe;AAChE,QAAM,SAAS,MAAM,MAAM;AAC3B,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,YAAY;;;AAIrB,IAAa,WAAb,cAA8B,YAAY;CACxC,YAAY,UAAkB,wBAAwB,YAAqB,OAAO,OAAe;AAC/F,QAAM,aAAa,SAAS,WAAW,MAAM;AAC7C,OAAK,OAAO;;;AAIhB,IAAa,gBAAb,cAAmC,SAAS;CAC1C,YAAY,UAAkB,sBAAsB,OAAe;AACjE,QAAM,SAAS,OAAO,MAAM;AAC5B,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,YAAY;;;AAIrB,IAAa,iBAAb,cAAoC,SAAS;;;;CAI3C;CAEA,YAAY,UAAkB,uBAAuB,YAAqB,OAAe;AACvF,QAAM,SAAS,MAAM,MAAM;AAC3B,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,YAAY;AACjB,OAAK,aAAa"}

package/dist/esm/index.d.ts

@@ -0,0 +1,16 @@
+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 { Pinner } from "./pinner.js";
+import { UploadManager } from "./upload/manager.js";
+import { CarPreprocessOptions, CarPreprocessResult, destroyCarPreprocessor, isCarFile, preprocessToCar } from "./upload/car.js";
+import { AuthenticationError, ConfigurationError, EmptyFileError, NetworkError, NotFoundError, PinError, PinnerError, RateLimitError, TimeoutError, UploadError, ValidationError } from "./errors/index.js";
+import { isAuthenticationError, isRetryable } from "./types/type-guards.js";
+import { FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM } from "./types/mime-types.js";
+import { UnstorageBlockstoreOptions, setDriverFactory } from "./blockstore/unstorage-base.js";
+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 "./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 };

package/dist/esm/index.js

@@ -0,0 +1,14 @@
+import { FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM } from "./types/mime-types.js";
+import { asyncGeneratorToReadableStream, calculateStreamSize, readableStreamToAsyncIterable, streamToBlob } from "./utils/stream.js";
+import { setDriverFactory } from "./blockstore/unstorage-base.js";
+import { createBlockstore, createDatastore } from "./blockstore/unstorage.js";
+import "./blockstore/index.js";
+import { destroyCarPreprocessor, isCarFile, preprocessToCar } from "./upload/car.js";
+import { AuthenticationError, ConfigurationError, EmptyFileError, NetworkError, NotFoundError, PinError, PinnerError, RateLimitError, TimeoutError, UploadError, ValidationError } from "./errors/index.js";
+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 "./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 };

package/dist/esm/pin/client.js

@@ -0,0 +1,95 @@
+import { ConfigurationError, NotFoundError } from "../errors/index.js";
+import { CID } from "multiformats/cid";
+import { Configuration, RemotePinningServiceClient } from "@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 ConfigurationError("JWT token is required");
+		this.client = new RemotePinningServiceClient(new 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 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 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: 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
+export { PinClient };
+//# sourceMappingURL=client.js.map

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

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

package/dist/esm/pin/index.js

@@ -0,0 +1 @@
+import { PinClient } from "./client.js";

package/dist/esm/pinner.d.ts

@@ -0,0 +1,77 @@
+import { PinnerConfig } from "./config.js";
+import { UploadOperation, UploadOptions, UploadResult } from "./types/upload.js";
+import { UploadMethodAndBuilder } from "./upload/builder.js";
+import { AbortOptions, RemoteAddOptions, RemoteLsOptions, RemotePin, RemotePins } from "./types/pin.js";
+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.ts.map

package/dist/esm/pinner.js

@@ -0,0 +1,125 @@
+import { UploadManager } from "./upload/manager.js";
+import { createUploadBuilderNamespace } from "./upload/builder.js";
+import "./upload/index.js";
+import { PinClient } from "./pin/client.js";
+import "./pin/index.js";
+import { CID } from "multiformats/cid";
+
+//#region src/pinner.ts
+var Pinner = class {
+	uploadManager;
+	_pins;
+	_upload;
+	constructor(config) {
+		this.uploadManager = new UploadManager(config);
+		this._pins = new 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 = 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" ? 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" ? CID.parse(cid) : cid;
+		return this.pins.get(cidObj);
+	}
+	/**
+	* Check if content is pinned.
+	*/
+	async isPinned(cid) {
+		const cidObj = typeof cid === "string" ? CID.parse(cid) : cid;
+		return this.pins.isPinned(cidObj);
+	}
+	/**
+	* Update pin metadata.
+	*/
+	async setPinMetadata(cid, metadata) {
+		const cidObj = typeof cid === "string" ? 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" ? 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
+export { Pinner };
+//# sourceMappingURL=pinner.js.map

package/dist/esm/pinner.js.map

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

package/dist/esm/types/constants.js

@@ -0,0 +1,29 @@
+//#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
+export { DEFAULT_BLOCKSTORE_BASE, DEFAULT_BLOCKSTORE_FS_BASE, DEFAULT_BLOCKSTORE_PREFIX, DEFAULT_ENDPOINT, TUS_SIZE_THRESHOLD };
+//# sourceMappingURL=constants.js.map

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

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

package/dist/esm/types/mime-types.d.ts

@@ -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.ts.map

package/dist/esm/types/mime-types.js

@@ -0,0 +1,8 @@
+//#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
+export { FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM };
+//# sourceMappingURL=mime-types.js.map

package/dist/esm/types/mime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-types.js","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"}