@lumeweb/pinner 0.0.1 → 0.1.1

package/dist/cjs/encoder/index.cjs

@@ -0,0 +1,6 @@
+const require_error = require('./error.cjs');
+const require_json = require('./json.cjs');
+const require_base64 = require('./base64.cjs');
+const require_url = require('./url.cjs');
+const require_csv = require('./csv.cjs');
+const require_text = require('./text.cjs');

package/dist/cjs/encoder/json.cjs

@@ -0,0 +1,36 @@
+const require_error = require('./error.cjs');
+
+//#region src/encoder/json.ts
+/**
+* JSON encoder - converts JSON objects to File objects.
+*/
+var JsonEncoder = class {
+	async encode(data, options) {
+		try {
+			const json = JSON.stringify(data, null, 2);
+			const blob = new Blob([json], { type: "application/json" });
+			const filename = options?.name || "data.json";
+			return {
+				file: new File([blob], filename, { type: "application/json" }),
+				options: {
+					name: options?.name,
+					keyvalues: options?.keyvalues
+				}
+			};
+		} catch (error) {
+			if (error instanceof Error) throw new require_error.EncoderError(`JSON encoding failed: ${error.message}`, "INVALID_JSON", error);
+			throw new require_error.EncoderError("JSON encoding failed: unknown error", "INVALID_JSON");
+		}
+	}
+};
+/**
+* Encode a JSON object to a File object.
+*/
+async function jsonToFile(data, options) {
+	return new JsonEncoder().encode(data, options);
+}
+
+//#endregion
+exports.JsonEncoder = JsonEncoder;
+exports.jsonToFile = jsonToFile;
+//# sourceMappingURL=json.cjs.map

package/dist/cjs/encoder/json.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.cjs","names":["EncoderError"],"sources":["../../../src/encoder/json.ts"],"sourcesContent":["import type { Encoder, EncoderResult, UploadOptions } from \"./types\";\nimport { EncoderError } from \"./error\";\n\n/**\n * JSON encoder - converts JSON objects to File objects.\n */\nexport class JsonEncoder implements Encoder<object> {\n  async encode(data: object, options?: UploadOptions): Promise<EncoderResult> {\n    try {\n      const json = JSON.stringify(data, null, 2);\n      const blob = new Blob([json], { type: \"application/json\" });\n      const filename = options?.name || \"data.json\";\n      const file = new File([blob], filename, { type: \"application/json\" });\n\n      return {\n        file,\n        options: {\n          name: options?.name,\n          keyvalues: options?.keyvalues,\n        },\n      };\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new EncoderError(\n          `JSON encoding failed: ${error.message}`,\n          \"INVALID_JSON\",\n          error,\n        );\n      }\n      throw new EncoderError(\n        \"JSON encoding failed: unknown error\",\n        \"INVALID_JSON\",\n      );\n    }\n  }\n}\n\n/**\n * Encode a JSON object to a File object.\n */\nexport async function jsonToFile(\n  data: object,\n  options?: UploadOptions,\n): Promise<EncoderResult> {\n  const encoder = new JsonEncoder();\n  return encoder.encode(data, options);\n}\n"],"mappings":";;;;;;AAMA,IAAa,cAAb,MAAoD;CAClD,MAAM,OAAO,MAAc,SAAiD;AAC1E,MAAI;GACF,MAAM,OAAO,KAAK,UAAU,MAAM,MAAM,EAAE;GAC1C,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,oBAAoB,CAAC;GAC3D,MAAM,WAAW,SAAS,QAAQ;AAGlC,UAAO;IACL,MAHW,IAAI,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;IAInE,SAAS;KACP,MAAM,SAAS;KACf,WAAW,SAAS;KACrB;IACF;WACM,OAAO;AACd,OAAI,iBAAiB,MACnB,OAAM,IAAIA,2BACR,yBAAyB,MAAM,WAC/B,gBACA,MACD;AAEH,SAAM,IAAIA,2BACR,uCACA,eACD;;;;;;;AAQP,eAAsB,WACpB,MACA,SACwB;AAExB,QADgB,IAAI,aAAa,CAClB,OAAO,MAAM,QAAQ"}

package/dist/cjs/encoder/text.cjs

@@ -0,0 +1,35 @@
+const require_error = require('./error.cjs');
+
+//#region src/encoder/text.ts
+/**
+* Text encoder - converts text strings to File objects.
+*/
+var TextEncoder = class {
+	async encode(data, options) {
+		try {
+			const blob = new Blob([data], { type: "text/plain" });
+			const filename = options?.name || "data.txt";
+			return {
+				file: new File([blob], filename, { type: "text/plain" }),
+				options: {
+					name: options?.name,
+					keyvalues: options?.keyvalues
+				}
+			};
+		} catch (error) {
+			if (error instanceof Error) throw new require_error.EncoderError(`Text encoding failed: ${error.message}`, "INVALID_TEXT", error);
+			throw new require_error.EncoderError("Text encoding failed: unknown error", "INVALID_TEXT");
+		}
+	}
+};
+/**
+* Encode a text string to a File object.
+*/
+async function textToFile(data, options) {
+	return new TextEncoder().encode(data, options);
+}
+
+//#endregion
+exports.TextEncoder = TextEncoder;
+exports.textToFile = textToFile;
+//# sourceMappingURL=text.cjs.map

package/dist/cjs/encoder/text.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.cjs","names":["EncoderError"],"sources":["../../../src/encoder/text.ts"],"sourcesContent":["import type { Encoder, EncoderResult, UploadOptions } from \"./types\";\nimport { EncoderError } from \"./error\";\n\n/**\n * Text encoder - converts text strings to File objects.\n */\nexport class TextEncoder implements Encoder<string> {\n  async encode(data: string, options?: UploadOptions): Promise<EncoderResult> {\n    try {\n      const blob = new Blob([data], { type: \"text/plain\" });\n      const filename = options?.name || \"data.txt\";\n      const file = new File([blob], filename, { type: \"text/plain\" });\n\n      return {\n        file,\n        options: {\n          name: options?.name,\n          keyvalues: options?.keyvalues,\n        },\n      };\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new EncoderError(\n          `Text encoding failed: ${error.message}`,\n          \"INVALID_TEXT\",\n          error,\n        );\n      }\n      throw new EncoderError(\n        \"Text encoding failed: unknown error\",\n        \"INVALID_TEXT\",\n      );\n    }\n  }\n}\n\n/**\n * Encode a text string to a File object.\n */\nexport async function textToFile(\n  data: string,\n  options?: UploadOptions,\n): Promise<EncoderResult> {\n  const encoder = new TextEncoder();\n  return encoder.encode(data, options);\n}\n"],"mappings":";;;;;;AAMA,IAAa,cAAb,MAAoD;CAClD,MAAM,OAAO,MAAc,SAAiD;AAC1E,MAAI;GACF,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,cAAc,CAAC;GACrD,MAAM,WAAW,SAAS,QAAQ;AAGlC,UAAO;IACL,MAHW,IAAI,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;IAI7D,SAAS;KACP,MAAM,SAAS;KACf,WAAW,SAAS;KACrB;IACF;WACM,OAAO;AACd,OAAI,iBAAiB,MACnB,OAAM,IAAIA,2BACR,yBAAyB,MAAM,WAC/B,gBACA,MACD;AAEH,SAAM,IAAIA,2BACR,uCACA,eACD;;;;;;;AAQP,eAAsB,WACpB,MACA,SACwB;AAExB,QADgB,IAAI,aAAa,CAClB,OAAO,MAAM,QAAQ"}

package/dist/cjs/encoder/url.cjs

@@ -0,0 +1,39 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_error = require('./error.cjs');
+let ky = require("ky");
+ky = require_rolldown_runtime.__toESM(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 (0, ky.default)(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 ((0, ky.isHTTPError)(error) || (0, ky.isTimeoutError)(error)) throw new require_error.EncoderError(`URL encoding failed: ${error.message}`, "NETWORK_ERROR", error);
+			if (error instanceof Error) throw new require_error.EncoderError(`URL encoding failed: ${error.message}`, "NETWORK_ERROR", error);
+			throw new require_error.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
+exports.UrlEncoder = UrlEncoder;
+exports.urlToFile = urlToFile;
+//# sourceMappingURL=url.cjs.map

package/dist/cjs/encoder/url.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.cjs","names":["EncoderError"],"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,sBAAS,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,2BAAgB,MAAM,2BAAmB,MAAM,CAC7C,OAAM,IAAIA,2BACR,wBAAwB,MAAM,WAC9B,iBACA,MACD;AAGH,OAAI,iBAAiB,MACnB,OAAM,IAAIA,2BACR,wBAAwB,MAAM,WAC9B,iBACA,MACD;AAGH,SAAM,IAAIA,2BAAa,sCAAsC,UAAU;;;;;;;AAQ7E,eAAsB,UACpB,WACA,SACwB;AAExB,QADgB,IAAI,YAAY,CACjB,OAAO,WAAW,QAAQ"}

package/dist/cjs/errors/index.cjs

@@ -0,0 +1,104 @@
+
+//#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
+exports.AuthenticationError = AuthenticationError;
+exports.ConfigurationError = ConfigurationError;
+exports.EmptyFileError = EmptyFileError;
+exports.NetworkError = NetworkError;
+exports.NotFoundError = NotFoundError;
+exports.PinError = PinError;
+exports.PinnerError = PinnerError;
+exports.RateLimitError = RateLimitError;
+exports.TimeoutError = TimeoutError;
+exports.UploadError = UploadError;
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/errors/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","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/cjs/errors/index.d.cts

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

package/dist/cjs/index.cjs

@@ -0,0 +1,44 @@
+const require_mime_types = require('./types/mime-types.cjs');
+const require_stream = require('./utils/stream.cjs');
+const require_unstorage_base = require('./blockstore/unstorage-base.cjs');
+const require_unstorage = require('./blockstore/unstorage.cjs');
+require('./blockstore/index.cjs');
+const require_car = require('./upload/car.cjs');
+const require_index$1 = require('./errors/index.cjs');
+const require_manager = require('./upload/manager.cjs');
+const require_pinner = require('./pinner.cjs');
+const require_type_guards = require('./types/type-guards.cjs');
+const require_adapter = require('./adapters/pinata/v2/adapter.cjs');
+const require_adapter$1 = require('./adapters/pinata/legacy/adapter.cjs');
+require('./adapters/pinata/index.cjs');
+
+exports.AuthenticationError = require_index$1.AuthenticationError;
+exports.ConfigurationError = require_index$1.ConfigurationError;
+exports.EmptyFileError = require_index$1.EmptyFileError;
+exports.FILE_EXTENSION_CAR = require_mime_types.FILE_EXTENSION_CAR;
+exports.MIME_TYPE_CAR = require_mime_types.MIME_TYPE_CAR;
+exports.MIME_TYPE_OCTET_STREAM = require_mime_types.MIME_TYPE_OCTET_STREAM;
+exports.NetworkError = require_index$1.NetworkError;
+exports.NotFoundError = require_index$1.NotFoundError;
+exports.PinError = require_index$1.PinError;
+exports.Pinner = require_pinner.Pinner;
+exports.PinnerError = require_index$1.PinnerError;
+exports.RateLimitError = require_index$1.RateLimitError;
+exports.TimeoutError = require_index$1.TimeoutError;
+exports.UploadError = require_index$1.UploadError;
+exports.UploadManager = require_manager.UploadManager;
+exports.ValidationError = require_index$1.ValidationError;
+exports.asyncGeneratorToReadableStream = require_stream.asyncGeneratorToReadableStream;
+exports.calculateStreamSize = require_stream.calculateStreamSize;
+exports.createBlockstore = require_unstorage.createBlockstore;
+exports.createDatastore = require_unstorage.createDatastore;
+exports.destroyCarPreprocessor = require_car.destroyCarPreprocessor;
+exports.isAuthenticationError = require_type_guards.isAuthenticationError;
+exports.isCarFile = require_car.isCarFile;
+exports.isRetryable = require_type_guards.isRetryable;
+exports.pinataAdapter = require_adapter.pinataAdapter;
+exports.pinataLegacyAdapter = require_adapter$1.pinataLegacyAdapter;
+exports.preprocessToCar = require_car.preprocessToCar;
+exports.readableStreamToAsyncIterable = require_stream.readableStreamToAsyncIterable;
+exports.setDriverFactory = require_unstorage_base.setDriverFactory;
+exports.streamToBlob = require_stream.streamToBlob;

package/dist/cjs/index.d.cts

@@ -0,0 +1,16 @@
+import { PinnerConfig } from "./config.cjs";
+import { UploadInput, UploadOperation, UploadOptions, UploadProgress, UploadResult } from "./types/upload.cjs";
+import { AbortOptions, RemoteAddOptions, RemoteLsOptions, RemotePin, RemotePins } from "./types/pin.cjs";
+import { Pinner } from "./pinner.cjs";
+import { UploadManager } from "./upload/manager.cjs";
+import { CarPreprocessOptions, CarPreprocessResult, destroyCarPreprocessor, isCarFile, preprocessToCar } from "./upload/car.cjs";
+import { AuthenticationError, ConfigurationError, EmptyFileError, NetworkError, NotFoundError, PinError, PinnerError, RateLimitError, TimeoutError, UploadError, ValidationError } from "./errors/index.cjs";
+import { isAuthenticationError, isRetryable } from "./types/type-guards.cjs";
+import { FILE_EXTENSION_CAR, MIME_TYPE_CAR, MIME_TYPE_OCTET_STREAM } from "./types/mime-types.cjs";
+import { UnstorageBlockstoreOptions, setDriverFactory } from "./blockstore/unstorage-base.cjs";
+import { createBlockstore, createDatastore } from "./blockstore/unstorage.cjs";
+import { asyncGeneratorToReadableStream, calculateStreamSize, readableStreamToAsyncIterable, streamToBlob } from "./utils/stream.cjs";
+import { PinataAdapter } from "./adapters/pinata/v2/adapter-interface.cjs";
+import { pinataAdapter } from "./adapters/pinata/v2/adapter.cjs";
+import { PinataLegacyAdapter, pinataLegacyAdapter } from "./adapters/pinata/legacy/adapter.cjs";
+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/cjs/pin/client.cjs

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

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

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

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

package/dist/cjs/pinner.cjs

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

package/dist/cjs/pinner.cjs.map

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