@lumeweb/pinner 0.0.1 → 0.1.0

package/dist/cjs/upload/xhr-upload.cjs

@@ -0,0 +1,41 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_upload = require('../types/upload.cjs');
+const require_constants = require('./constants.cjs');
+const require_base_upload = require('./base-upload.cjs');
+let _lumeweb_uppy_post_upload = require("@lumeweb/uppy-post-upload");
+_lumeweb_uppy_post_upload = require_rolldown_runtime.__toESM(_lumeweb_uppy_post_upload);
+
+//#region src/upload/xhr-upload.ts
+var XHRUploadHandler = class extends require_base_upload.BaseUploadHandler {
+	configurePlugin(uppy) {
+		uppy.use(_lumeweb_uppy_post_upload.default, {
+			endpoint: `${this.config.endpoint}/api/upload`,
+			fieldName: "file",
+			formData: true,
+			headers: { Authorization: `Bearer ${this.config.jwt}` }
+		});
+	}
+	parseResult(result) {
+		const uppyResponse = result;
+		const response = uppyResponse.body || uppyResponse;
+		return {
+			id: response.id,
+			cid: response.cid,
+			name: response.name,
+			size: response.size,
+			mimeType: response.mimeType,
+			createdAt: new Date(response.createdAt),
+			numberOfFiles: response.numberOfFiles,
+			keyvalues: response.keyvalues,
+			operationId: response.operationId,
+			[require_upload.UploadResultSymbol]: true
+		};
+	}
+	getUploadSource() {
+		return require_constants.UPLOAD_SOURCE_XHR;
+	}
+};
+
+//#endregion
+exports.XHRUploadHandler = XHRUploadHandler;
+//# sourceMappingURL=xhr-upload.cjs.map

package/dist/cjs/upload/xhr-upload.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"xhr-upload.cjs","names":["BaseUploadHandler","XHRUpload","UploadResultSymbol","UPLOAD_SOURCE_XHR"],"sources":["../../../src/upload/xhr-upload.ts"],"sourcesContent":["import Uppy from \"@uppy/core\";\nimport XHRUpload from \"@lumeweb/uppy-post-upload\";\nimport type { UploadResult } from \"@/types/upload\";\nimport { UploadResultSymbol } from \"@/types/upload\";\nimport { BaseUploadHandler } from \"./base-upload\";\nimport { UPLOAD_SOURCE_XHR } from \"./constants\";\n\nexport class XHRUploadHandler extends BaseUploadHandler {\n  protected configurePlugin(uppy: Uppy): void {\n    uppy.use(XHRUpload, {\n      endpoint: `${this.config.endpoint}/api/upload`,\n      fieldName: \"file\",\n      formData: true,\n      headers: {\n        Authorization: `Bearer ${this.config.jwt}`,\n      },\n    });\n  }\n\n  protected parseResult(result: unknown): UploadResult {\n    const uppyResponse = result as {\n      uploadURL: string;\n      body?: {\n        id: string;\n        cid: string;\n        name: string;\n        size: number;\n        mimeType: string;\n        createdAt: string;\n        numberOfFiles: number;\n        keyvalues?: Record<string, string>;\n        operationId?: number;\n      };\n    };\n\n    const response = uppyResponse.body || (uppyResponse as any);\n\n    return {\n      id: response.id,\n      cid: response.cid,\n      name: response.name,\n      size: response.size,\n      mimeType: response.mimeType,\n      createdAt: new Date(response.createdAt),\n      numberOfFiles: response.numberOfFiles,\n      keyvalues: response.keyvalues,\n      operationId: response.operationId,\n      [UploadResultSymbol]: true,\n    };\n  }\n\n  protected getUploadSource(): string {\n    return UPLOAD_SOURCE_XHR;\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,mBAAb,cAAsCA,sCAAkB;CACtD,AAAU,gBAAgB,MAAkB;AAC1C,OAAK,IAAIC,mCAAW;GAClB,UAAU,GAAG,KAAK,OAAO,SAAS;GAClC,WAAW;GACX,UAAU;GACV,SAAS,EACP,eAAe,UAAU,KAAK,OAAO,OACtC;GACF,CAAC;;CAGJ,AAAU,YAAY,QAA+B;EACnD,MAAM,eAAe;EAerB,MAAM,WAAW,aAAa,QAAS;AAEvC,SAAO;GACL,IAAI,SAAS;GACb,KAAK,SAAS;GACd,MAAM,SAAS;GACf,MAAM,SAAS;GACf,UAAU,SAAS;GACnB,WAAW,IAAI,KAAK,SAAS,UAAU;GACvC,eAAe,SAAS;GACxB,WAAW,SAAS;GACpB,aAAa,SAAS;IACrBC,oCAAqB;GACvB;;CAGH,AAAU,kBAA0B;AAClC,SAAOC"}

package/dist/cjs/utils/env.cjs

@@ -0,0 +1,12 @@
+
+//#region src/utils/env.ts
+/**
+* Check if the current environment is Node.js.
+*/
+function isNodeEnvironment() {
+	return typeof process !== "undefined" && process?.versions?.node !== void 0;
+}
+
+//#endregion
+exports.isNodeEnvironment = isNodeEnvironment;
+//# sourceMappingURL=env.cjs.map

package/dist/cjs/utils/env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.cjs","names":[],"sources":["../../../src/utils/env.ts"],"sourcesContent":["/**\n * Check if the current environment is Node.js.\n */\nexport function isNodeEnvironment(): boolean {\n  return typeof process !== 'undefined' && process?.versions?.node !== undefined;\n}\n"],"mappings":";;;;;AAGA,SAAgB,oBAA6B;AAC3C,QAAO,OAAO,YAAY,eAAe,SAAS,UAAU,SAAS"}

package/dist/cjs/utils/stream.cjs

@@ -0,0 +1,141 @@
+const require_env = require('./env.cjs');
+
+//#region src/utils/stream.ts
+/**
+* Convert a ReadableStream to a Blob.
+*/
+async function streamToBlob(stream, mimeType) {
+	const chunks = [];
+	const reader = stream.getReader();
+	while (true) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		chunks.push(value);
+	}
+	return new Blob(chunks, { type: mimeType });
+}
+/**
+* Calculate the total size of a ReadableStream by consuming it.
+*/
+async function calculateStreamSize(stream, signal) {
+	let size = 0n;
+	const reader = stream.getReader();
+	while (true) {
+		if (signal?.aborted) throw new Error("Aborted");
+		const { done, value } = await reader.read();
+		if (done) break;
+		size += BigInt(value.length);
+	}
+	return size;
+}
+/**
+* Convert an async generator to a ReadableStream.
+*/
+function asyncGeneratorToReadableStream(generator) {
+	return new ReadableStream({ async start(controller) {
+		try {
+			for await (const item of generator) controller.enqueue(item);
+			controller.close();
+		} catch (error) {
+			controller.error(error);
+		}
+	} });
+}
+/**
+* Convert a ReadableStream to an async iterable.
+*/
+async function* readableStreamToAsyncIterable(stream) {
+	const reader = stream.getReader();
+	try {
+		while (true) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			yield value;
+		}
+	} finally {
+		reader.releaseLock();
+	}
+}
+/**
+* Convert a web ReadableStream to a Node.js stream.Readable
+* This is needed for Node.js environments where tus-js-client expects Node streams.
+*/
+async function readableStreamToNodeStream(stream) {
+	if (!require_env.isNodeEnvironment()) throw new Error("readableStreamToNodeStream can only be used in Node.js environment");
+	const { Readable } = await import("stream");
+	const reader = stream.getReader();
+	return new Readable({
+		async read() {
+			try {
+				const { done, value } = await reader.read();
+				if (done) {
+					reader.releaseLock();
+					this.push(null);
+				} else this.push(Buffer.from(value));
+			} catch (error) {
+				reader.releaseLock();
+				this.destroy(error);
+			}
+		},
+		destroy(error, callback) {
+			try {
+				reader.releaseLock();
+			} catch (e) {}
+			if (callback) callback(error);
+		}
+	});
+}
+/**
+* Convert a ReadableStream to a Blob using the Response API.
+* This is the preferred method in browser environments as it's built-in and efficient.
+*/
+async function streamToBlobViaResponse(stream) {
+	return new Response(stream).blob();
+}
+/**
+* Convert a File to a ReadableStream of Uint8Array without loading entire blob into memory.
+* This streams the file content chunk by chunk.
+*/
+function fileToReadableStream(file) {
+	return new ReadableStream({ async start(controller) {
+		try {
+			const reader = file.stream().getReader();
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) {
+					controller.close();
+					break;
+				}
+				controller.enqueue(value);
+			}
+		} catch (error) {
+			controller.error(error);
+		}
+	} });
+}
+/**
+* Collect all chunks from an async iterable or iterable into a single Uint8Array.
+*/
+async function collectAsyncIterable(iterable) {
+	const chunks = [];
+	for await (const chunk of iterable) chunks.push(chunk);
+	const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
+	const result = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const chunk of chunks) {
+		result.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return result;
+}
+
+//#endregion
+exports.asyncGeneratorToReadableStream = asyncGeneratorToReadableStream;
+exports.calculateStreamSize = calculateStreamSize;
+exports.collectAsyncIterable = collectAsyncIterable;
+exports.fileToReadableStream = fileToReadableStream;
+exports.readableStreamToAsyncIterable = readableStreamToAsyncIterable;
+exports.readableStreamToNodeStream = readableStreamToNodeStream;
+exports.streamToBlob = streamToBlob;
+exports.streamToBlobViaResponse = streamToBlobViaResponse;
+//# sourceMappingURL=stream.cjs.map

package/dist/cjs/utils/stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.cjs","names":["isNodeEnvironment"],"sources":["../../../src/utils/stream.ts"],"sourcesContent":["import type { AwaitIterable } from \"interface-store\";\nimport { isNodeEnvironment } from \"./env\";\n\n/**\n * Convert a ReadableStream to a Blob.\n */\nexport async function streamToBlob(\n  stream: ReadableStream<Uint8Array>,\n  mimeType: string,\n): Promise<Blob> {\n  const chunks: Uint8Array[] = [];\n  const reader = stream.getReader();\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    chunks.push(value);\n  }\n\n  return new Blob(chunks as any, { type: mimeType });\n}\n\n/**\n * Calculate the total size of a ReadableStream by consuming it.\n */\nexport async function calculateStreamSize(\n  stream: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n): Promise<bigint> {\n  let size = 0n;\n  const reader = stream.getReader();\n\n  while (true) {\n    if (signal?.aborted) {\n      throw new Error(\"Aborted\");\n    }\n\n    const { done, value } = await reader.read();\n    if (done) break;\n    size += BigInt(value.length);\n  }\n\n  return size;\n}\n\n/**\n * Convert an async generator to a ReadableStream.\n */\nexport function asyncGeneratorToReadableStream<T>(\n  generator: AsyncGenerator<T>,\n): ReadableStream<T> {\n  return new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const item of generator) {\n          controller.enqueue(item);\n        }\n        controller.close();\n      } catch (error) {\n        controller.error(error);\n      }\n    },\n  });\n}\n\n/**\n * Convert a ReadableStream to an async iterable.\n */\nexport async function* readableStreamToAsyncIterable<T>(\n  stream: ReadableStream<T>,\n): AsyncIterable<T> {\n  const reader = stream.getReader();\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      yield value;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/**\n * Convert a web ReadableStream to a Node.js stream.Readable\n * This is needed for Node.js environments where tus-js-client expects Node streams.\n */\nexport async function readableStreamToNodeStream(\n  stream: ReadableStream<Uint8Array>,\n): Promise<import(\"stream\").Readable> {\n  if (!isNodeEnvironment()) {\n    throw new Error(\n      \"readableStreamToNodeStream can only be used in Node.js environment\",\n    );\n  }\n\n  const { Readable } = await import(\"stream\");\n\n  // Create a single reader for the entire stream lifecycle\n  // The read() method is called multiple times by Node.js, so we cannot\n  // call getReader() inside it - that would create multiple readers and\n  // cause \"ReadableStream is locked\" errors\n  const reader = stream.getReader();\n\n  return new Readable({\n    async read() {\n      try {\n        const { done, value } = await reader.read();\n        if (done) {\n          reader.releaseLock();\n          this.push(null);\n        } else {\n          this.push(Buffer.from(value));\n        }\n      } catch (error) {\n        reader.releaseLock();\n        this.destroy(error as Error);\n      }\n    },\n\n    // Ensure reader is released if stream is destroyed\n    destroy(error, callback) {\n      try {\n        reader.releaseLock();\n      } catch (e) {\n        // Ignore errors during cleanup\n      }\n      if (callback) callback(error);\n    },\n  });\n}\n\n/**\n * Convert a ReadableStream to a Blob using the Response API.\n * This is the preferred method in browser environments as it's built-in and efficient.\n */\nexport async function streamToBlobViaResponse(\n  stream: ReadableStream<Uint8Array>,\n): Promise<Blob> {\n  return new Response(stream).blob();\n}\n\n/**\n * Convert a File to a ReadableStream of Uint8Array without loading entire blob into memory.\n * This streams the file content chunk by chunk.\n */\nexport function fileToReadableStream(file: File): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    async start(controller) {\n      try {\n        const reader = (file as any).stream().getReader();\n\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) {\n            controller.close();\n            break;\n          }\n          controller.enqueue(value);\n        }\n      } catch (error) {\n        controller.error(error);\n      }\n    },\n  });\n}\n\n/**\n * Collect all chunks from an async iterable or iterable into a single Uint8Array.\n */\nexport async function collectAsyncIterable(\n  iterable: AwaitIterable<Uint8Array>,\n): Promise<Uint8Array> {\n  const chunks: Uint8Array[] = [];\n  for await (const chunk of iterable) {\n    chunks.push(chunk);\n  }\n\n  const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.length;\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;AAMA,eAAsB,aACpB,QACA,UACe;CACf,MAAM,SAAuB,EAAE;CAC/B,MAAM,SAAS,OAAO,WAAW;AAEjC,QAAO,MAAM;EACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,MAAI,KAAM;AACV,SAAO,KAAK,MAAM;;AAGpB,QAAO,IAAI,KAAK,QAAe,EAAE,MAAM,UAAU,CAAC;;;;;AAMpD,eAAsB,oBACpB,QACA,QACiB;CACjB,IAAI,OAAO;CACX,MAAM,SAAS,OAAO,WAAW;AAEjC,QAAO,MAAM;AACX,MAAI,QAAQ,QACV,OAAM,IAAI,MAAM,UAAU;EAG5B,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,MAAI,KAAM;AACV,UAAQ,OAAO,MAAM,OAAO;;AAG9B,QAAO;;;;;AAMT,SAAgB,+BACd,WACmB;AACnB,QAAO,IAAI,eAAe,EACxB,MAAM,MAAM,YAAY;AACtB,MAAI;AACF,cAAW,MAAM,QAAQ,UACvB,YAAW,QAAQ,KAAK;AAE1B,cAAW,OAAO;WACX,OAAO;AACd,cAAW,MAAM,MAAM;;IAG5B,CAAC;;;;;AAMJ,gBAAuB,8BACrB,QACkB;CAClB,MAAM,SAAS,OAAO,WAAW;AAEjC,KAAI;AACF,SAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,OAAI,KAAM;AACV,SAAM;;WAEA;AACR,SAAO,aAAa;;;;;;;AAQxB,eAAsB,2BACpB,QACoC;AACpC,KAAI,CAACA,+BAAmB,CACtB,OAAM,IAAI,MACR,qEACD;CAGH,MAAM,EAAE,aAAa,MAAM,OAAO;CAMlC,MAAM,SAAS,OAAO,WAAW;AAEjC,QAAO,IAAI,SAAS;EAClB,MAAM,OAAO;AACX,OAAI;IACF,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,QAAI,MAAM;AACR,YAAO,aAAa;AACpB,UAAK,KAAK,KAAK;UAEf,MAAK,KAAK,OAAO,KAAK,MAAM,CAAC;YAExB,OAAO;AACd,WAAO,aAAa;AACpB,SAAK,QAAQ,MAAe;;;EAKhC,QAAQ,OAAO,UAAU;AACvB,OAAI;AACF,WAAO,aAAa;YACb,GAAG;AAGZ,OAAI,SAAU,UAAS,MAAM;;EAEhC,CAAC;;;;;;AAOJ,eAAsB,wBACpB,QACe;AACf,QAAO,IAAI,SAAS,OAAO,CAAC,MAAM;;;;;;AAOpC,SAAgB,qBAAqB,MAAwC;AAC3E,QAAO,IAAI,eAA2B,EACpC,MAAM,MAAM,YAAY;AACtB,MAAI;GACF,MAAM,SAAU,KAAa,QAAQ,CAAC,WAAW;AAEjD,UAAO,MAAM;IACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,QAAI,MAAM;AACR,gBAAW,OAAO;AAClB;;AAEF,eAAW,QAAQ,MAAM;;WAEpB,OAAO;AACd,cAAW,MAAM,MAAM;;IAG5B,CAAC;;;;;AAMJ,eAAsB,qBACpB,UACqB;CACrB,MAAM,SAAuB,EAAE;AAC/B,YAAW,MAAM,SAAS,SACxB,QAAO,KAAK,MAAM;CAGpB,MAAM,cAAc,OAAO,QAAQ,KAAK,UAAU,MAAM,MAAM,QAAQ,EAAE;CACxE,MAAM,SAAS,IAAI,WAAW,YAAY;CAC1C,IAAI,SAAS;AACb,MAAK,MAAM,SAAS,QAAQ;AAC1B,SAAO,IAAI,OAAO,OAAO;AACzB,YAAU,MAAM;;AAGlB,QAAO"}

package/dist/cjs/utils/stream.d.cts

@@ -0,0 +1,23 @@
+import "stream";
+
+//#region src/utils/stream.d.ts
+
+/**
+ * Convert a ReadableStream to a Blob.
+ */
+declare function streamToBlob(stream: ReadableStream<Uint8Array>, mimeType: string): Promise<Blob>;
+/**
+ * Calculate the total size of a ReadableStream by consuming it.
+ */
+declare function calculateStreamSize(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): Promise<bigint>;
+/**
+ * Convert an async generator to a ReadableStream.
+ */
+declare function asyncGeneratorToReadableStream<T>(generator: AsyncGenerator<T>): ReadableStream<T>;
+/**
+ * Convert a ReadableStream to an async iterable.
+ */
+declare function readableStreamToAsyncIterable<T>(stream: ReadableStream<T>): AsyncIterable<T>;
+//#endregion
+export { asyncGeneratorToReadableStream, calculateStreamSize, readableStreamToAsyncIterable, streamToBlob };
+//# sourceMappingURL=stream.d.cts.map

package/dist/cjs/utils/tus-patch.cjs

@@ -0,0 +1,50 @@
+const require_env = require('./env.cjs');
+
+//#region src/utils/tus-patch.ts
+/**
+* Runtime patch for tus-js-client's NodeHttpStack Request class.
+*
+* PROBLEM:
+* Code using onBeforeRequest hook may need to call abort() on the request
+* before send() is called. However, the Request class only sets this._request
+* inside the send() method, so getUnderlyingObject() returns null before send().
+*
+* SOLUTION:
+* Patch the Request class to initialize a dummy _request object with an abort()
+* method immediately when the request is created.
+*
+* NOTE:
+* This patch is only needed in Node.js environments. In browser environments,
+* the tus-js-client uses a different HTTP stack that doesn't have this issue.
+*/
+function patchTusNodeHttpStack() {
+	if (!require_env.isNodeEnvironment()) return;
+	try {
+		const tusHttpStackModule = require("tus-js-client/lib.es5/node/httpStack");
+		if (!tusHttpStackModule || !tusHttpStackModule.default) {
+			console.warn("[tus-patch] tus-js-client NodeHttpStack not found, patch skipped");
+			return;
+		}
+		const NodeHttpStack = tusHttpStackModule.default;
+		const originalCreateRequest = NodeHttpStack.prototype.createRequest;
+		if (typeof originalCreateRequest !== "function") {
+			console.warn("[tus-patch] createRequest method not found, patch skipped");
+			return;
+		}
+		NodeHttpStack.prototype.createRequest = function(method, url) {
+			const request = originalCreateRequest.call(this, method, url);
+			request._request = {
+				abort: () => {},
+				destroyed: false
+			};
+			return request;
+		};
+		console.debug("[tus-patch] Successfully patched tus-js-client NodeHttpStack");
+	} catch (error) {
+		console.warn("[tus-patch] Failed to patch tus-js-client:", error);
+	}
+}
+
+//#endregion
+exports.patchTusNodeHttpStack = patchTusNodeHttpStack;
+//# sourceMappingURL=tus-patch.cjs.map

package/dist/cjs/utils/tus-patch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tus-patch.cjs","names":["isNodeEnvironment"],"sources":["../../../src/utils/tus-patch.ts"],"sourcesContent":["/**\n * Runtime patch for tus-js-client's NodeHttpStack Request class.\n *\n * PROBLEM:\n * Code using onBeforeRequest hook may need to call abort() on the request\n * before send() is called. However, the Request class only sets this._request\n * inside the send() method, so getUnderlyingObject() returns null before send().\n *\n * SOLUTION:\n * Patch the Request class to initialize a dummy _request object with an abort()\n * method immediately when the request is created.\n *\n * NOTE:\n * This patch is only needed in Node.js environments. In browser environments,\n * the tus-js-client uses a different HTTP stack that doesn't have this issue.\n */\n\nimport { isNodeEnvironment } from \"./env\";\n\n// Track whether the patch has been applied to prevent multiple patches\nlet isPatched = false;\n\nexport function patchTusNodeHttpStack(): void {\n  // Prevent multiple patches\n  if (isPatched) {\n    return;\n  }\n\n  // Only apply patch in Node.js environments\n  if (!isNodeEnvironment()) {\n    return;\n  }\n\n  // Find the tus-js-client NodeHttpStack module\n  // It exports the default as NodeHttpStack with a nested Request class\n  try {\n    // Use dynamic require() to avoid bundling issues\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const tusHttpStackModule = require(\"tus-js-client/lib.es5/node/httpStack\");\n\n    if (!tusHttpStackModule || !tusHttpStackModule.default) {\n      console.warn(\n        \"[tus-patch] tus-js-client NodeHttpStack not found, patch skipped\",\n      );\n      return;\n    }\n\n    const NodeHttpStack = tusHttpStackModule.default;\n\n    // Get the original createRequest method\n    const originalCreateRequest = NodeHttpStack.prototype.createRequest;\n\n    if (typeof originalCreateRequest !== \"function\") {\n      console.warn(\"[tus-patch] createRequest method not found, patch skipped\");\n      return;\n    }\n\n    // Patch createRequest to set up a dummy _request on the Request instance\n    NodeHttpStack.prototype.createRequest = function (\n      method: string,\n      url: string,\n    ) {\n      // Call the original createRequest to get the Request instance\n      const request = originalCreateRequest.call(this, method, url);\n\n      // Set a dummy _request object with an abort() method\n      // This allows getUnderlyingObject().abort() to work before send() is called\n      request._request = {\n        abort: () => {\n          // No-op abort before actual request is created\n          // The real request will be created in send() and this will be replaced\n        },\n        // Preserve any existing properties that might be checked\n        destroyed: false,\n      };\n\n      return request;\n    };\n\n    console.debug(\n      \"[tus-patch] Successfully patched tus-js-client NodeHttpStack\",\n    );\n  } catch (error) {\n    console.warn(\"[tus-patch] Failed to patch tus-js-client:\", error);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,wBAA8B;AAO5C,KAAI,CAACA,+BAAmB,CACtB;AAKF,KAAI;EAGF,MAAM,qBAAqB,QAAQ,uCAAuC;AAE1E,MAAI,CAAC,sBAAsB,CAAC,mBAAmB,SAAS;AACtD,WAAQ,KACN,mEACD;AACD;;EAGF,MAAM,gBAAgB,mBAAmB;EAGzC,MAAM,wBAAwB,cAAc,UAAU;AAEtD,MAAI,OAAO,0BAA0B,YAAY;AAC/C,WAAQ,KAAK,4DAA4D;AACzE;;AAIF,gBAAc,UAAU,gBAAgB,SACtC,QACA,KACA;GAEA,MAAM,UAAU,sBAAsB,KAAK,MAAM,QAAQ,IAAI;AAI7D,WAAQ,WAAW;IACjB,aAAa;IAKb,WAAW;IACZ;AAED,UAAO;;AAGT,UAAQ,MACN,+DACD;UACM,OAAO;AACd,UAAQ,KAAK,8CAA8C,MAAM"}

package/dist/cjs/utils/validation.cjs

@@ -0,0 +1,62 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_index = require('../errors/index.cjs');
+let ipaddr_js = require("ipaddr.js");
+ipaddr_js = require_rolldown_runtime.__toESM(ipaddr_js);
+
+//#region src/utils/validation.ts
+/**
+* URL validation utilities to prevent SSRF and other security issues.
+*/
+const BLOCKED_IPV4_RANGES = new Set([
+	"private",
+	"loopback",
+	"linkLocal",
+	"reserved",
+	"broadcast",
+	"carrierGradeNat",
+	"unspecified"
+]);
+const BLOCKED_IPV6_RANGES = new Set([
+	"uniqueLocal",
+	"loopback",
+	"linkLocal",
+	"reserved",
+	"multicast",
+	"ipv4Mapped",
+	"unspecified"
+]);
+/**
+* Validates a URL string to ensure it's safe to fetch.
+* Only allows HTTP/HTTPS protocols and validates the URL format.
+*
+* @param urlString - The URL string to validate
+* @throws ValidationError if the URL is invalid or uses an unsafe protocol
+*/
+function validateUrl(urlString) {
+	if (/\s/.test(urlString)) throw new require_index.ValidationError(`Invalid URL: contains whitespace characters`, "url");
+	try {
+		const url = new URL(urlString);
+		if (url.protocol !== "http:" && url.protocol !== "https:") throw new require_index.ValidationError(`Invalid URL protocol: ${url.protocol}. Only http: and https: are allowed.`, "url");
+		const hostname = url.hostname.toLowerCase();
+		if (hostname === "localhost") throw new require_index.ValidationError("Access to localhost addresses is not allowed", "url");
+		const cleanHostname = hostname.replace(/^\[|\]$/g, "");
+		if (ipaddr_js.default.isValid(cleanHostname)) {
+			const addr = ipaddr_js.default.parse(cleanHostname);
+			if (addr.kind() === "ipv4") {
+				const range = addr.range();
+				if (BLOCKED_IPV4_RANGES.has(range)) throw new require_index.ValidationError("Access to private IP addresses is not allowed", "url");
+			}
+			if (addr.kind() === "ipv6") {
+				const range = addr.range();
+				if (BLOCKED_IPV6_RANGES.has(range)) throw new require_index.ValidationError("Access to private IP addresses is not allowed", "url");
+			}
+		}
+	} catch (error) {
+		if (error instanceof require_index.ValidationError) throw error;
+		throw new require_index.ValidationError(`Invalid URL format: ${urlString}`, "url", error);
+	}
+}
+
+//#endregion
+exports.validateUrl = validateUrl;
+//# sourceMappingURL=validation.cjs.map

package/dist/cjs/utils/validation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.cjs","names":["ValidationError","ipaddr"],"sources":["../../../src/utils/validation.ts"],"sourcesContent":["/**\n * URL validation utilities to prevent SSRF and other security issues.\n */\n\nimport { ValidationError } from \"@/errors\";\nimport ipaddr from \"ipaddr.js\";\n\nexport { ValidationError };\n\n// IPv4 ranges to block\nconst BLOCKED_IPV4_RANGES = new Set([\n  \"private\", // 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16\n  \"loopback\", // 127.0.0.0/8\n  \"linkLocal\", // 169.254.0.0/16\n  \"reserved\",\n  \"broadcast\",\n  \"carrierGradeNat\", // 100.64.0.0/10\n  \"unspecified\", // 0.0.0.0/8\n]);\n\n// IPv6 ranges to block\nconst BLOCKED_IPV6_RANGES = new Set([\n  \"uniqueLocal\", // fc00::/7\n  \"loopback\", // ::1\n  \"linkLocal\", // fe80::/10\n  \"reserved\",\n  \"multicast\", // ff00::/8\n  \"ipv4Mapped\", // ::ffff:0:0/96\n  \"unspecified\", // ::\n]);\n\n/**\n * Validates a URL string to ensure it's safe to fetch.\n * Only allows HTTP/HTTPS protocols and validates the URL format.\n *\n * @param urlString - The URL string to validate\n * @throws ValidationError if the URL is invalid or uses an unsafe protocol\n */\nexport function validateUrl(urlString: string): void {\n  // Reject URLs with spaces or other invalid characters that shouldn't be in URLs\n  if (/\\s/.test(urlString)) {\n    throw new ValidationError(\n      `Invalid URL: contains whitespace characters`,\n      \"url\",\n    );\n  }\n\n  try {\n    const url = new URL(urlString);\n\n    // Only allow HTTP and HTTPS protocols\n    if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n      throw new ValidationError(\n        `Invalid URL protocol: ${url.protocol}. Only http: and https: are allowed.`,\n        \"url\",\n      );\n    }\n\n    const hostname = url.hostname.toLowerCase();\n\n    // Block localhost (case-insensitive)\n    if (hostname === \"localhost\") {\n      throw new ValidationError(\n        \"Access to localhost addresses is not allowed\",\n        \"url\",\n      );\n    }\n\n    // Strip brackets from IPv6 addresses for ipaddr.js\n    const cleanHostname = hostname.replace(/^\\[|\\]$/g, \"\");\n\n    // Block IP addresses using ipaddr.js\n    // This library handles alternative notations (decimal, octal, hex)\n    // and comprehensive private range detection for both IPv4 and IPv6\n    if (ipaddr.isValid(cleanHostname)) {\n      const addr = ipaddr.parse(cleanHostname);\n\n      // Check for IPv4 private ranges\n      if (addr.kind() === \"ipv4\") {\n        const ipv4Addr = addr as ipaddr.IPv4;\n        const range = ipv4Addr.range();\n\n        if (BLOCKED_IPV4_RANGES.has(range)) {\n          throw new ValidationError(\n            \"Access to private IP addresses is not allowed\",\n            \"url\",\n          );\n        }\n      }\n\n      // Check for IPv6 private ranges\n      if (addr.kind() === \"ipv6\") {\n        const ipv6Addr = addr as ipaddr.IPv6;\n        const range = ipv6Addr.range();\n\n        if (BLOCKED_IPV6_RANGES.has(range)) {\n          throw new ValidationError(\n            \"Access to private IP addresses is not allowed\",\n            \"url\",\n          );\n        }\n      }\n    }\n  } catch (error) {\n    if (error instanceof ValidationError) {\n      throw error;\n    }\n    throw new ValidationError(\n      `Invalid URL format: ${urlString}`,\n      \"url\",\n      error as Error,\n    );\n  }\n}\n\n/**\n * Validates a URL and returns the parsed URL object if valid.\n *\n * @param urlString - The URL string to validate\n * @returns The parsed URL object\n * @throws ValidationError if the URL is invalid\n */\nexport function parseValidatedUrl(urlString: string): URL {\n  validateUrl(urlString);\n  return new URL(urlString);\n}\n"],"mappings":";;;;;;;;;AAUA,MAAM,sBAAsB,IAAI,IAAI;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAGF,MAAM,sBAAsB,IAAI,IAAI;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;AASF,SAAgB,YAAY,WAAyB;AAEnD,KAAI,KAAK,KAAK,UAAU,CACtB,OAAM,IAAIA,8BACR,+CACA,MACD;AAGH,KAAI;EACF,MAAM,MAAM,IAAI,IAAI,UAAU;AAG9B,MAAI,IAAI,aAAa,WAAW,IAAI,aAAa,SAC/C,OAAM,IAAIA,8BACR,yBAAyB,IAAI,SAAS,uCACtC,MACD;EAGH,MAAM,WAAW,IAAI,SAAS,aAAa;AAG3C,MAAI,aAAa,YACf,OAAM,IAAIA,8BACR,gDACA,MACD;EAIH,MAAM,gBAAgB,SAAS,QAAQ,YAAY,GAAG;AAKtD,MAAIC,kBAAO,QAAQ,cAAc,EAAE;GACjC,MAAM,OAAOA,kBAAO,MAAM,cAAc;AAGxC,OAAI,KAAK,MAAM,KAAK,QAAQ;IAE1B,MAAM,QADW,KACM,OAAO;AAE9B,QAAI,oBAAoB,IAAI,MAAM,CAChC,OAAM,IAAID,8BACR,iDACA,MACD;;AAKL,OAAI,KAAK,MAAM,KAAK,QAAQ;IAE1B,MAAM,QADW,KACM,OAAO;AAE9B,QAAI,oBAAoB,IAAI,MAAM,CAChC,OAAM,IAAIA,8BACR,iDACA,MACD;;;UAIA,OAAO;AACd,MAAI,iBAAiBA,8BACnB,OAAM;AAER,QAAM,IAAIA,8BACR,uBAAuB,aACvB,OACA,MACD"}

package/dist/esm/_virtual/rolldown_runtime.js

@@ -0,0 +1,8 @@
+//#region rolldown:runtime
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function.");
+});
+
+//#endregion
+export { __require };

package/dist/esm/adapters/pinata/adapter.d.ts

@@ -0,0 +1,35 @@
+import { Pinner } from "../../pinner.js";
+import { PinByHashOptions, PinataFile, PinataListBuilder, PinataPin, PinataUploadBuilder, PinataUploadResult } from "../../types/pinata.js";
+
+//#region src/adapters/pinata/adapter.d.ts
+
+/**
+ * Creates a Pinata-compatible adapter for the Pinner client.
+ * This allows users to migrate from Pinata SDK with minimal code changes.
+ */
+interface PinataAdapter {
+  upload: {
+    file(file: File): PinataUploadBuilder<PinataUploadResult>;
+    fileArray(files: File[]): PinataUploadBuilder<PinataUploadResult>;
+    json(data: object): PinataUploadBuilder<PinataUploadResult>;
+    base64(base64String: string): PinataUploadBuilder<PinataUploadResult>;
+    url(urlString: string): PinataUploadBuilder<PinataUploadResult>;
+    cid(cidString: string): PinataUploadBuilder<void>;
+  };
+  pinByHash(cid: string, options?: PinByHashOptions): Promise<void>;
+  unpin(cid: string): Promise<void>;
+  getPinStatus(cid: string): Promise<PinataPin>;
+  isPinned(cid: string): Promise<boolean>;
+  setPinMetadata(cid: string, metadata: Record<string, string>): Promise<void>;
+  files: {
+    list(): PinataListBuilder<PinataFile[]>;
+    get(id: string): Promise<PinataFile>;
+  };
+}
+/**
+ * Creates a Pinata-compatible adapter for the Pinner client.
+ */
+declare function pinataAdapter(pinner: Pinner): PinataAdapter;
+//#endregion
+export { PinataAdapter, pinataAdapter };
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1,87 @@
+import { createBase64UploadBuilder, createCidUploadBuilder, createFileArrayUploadBuilder, createJsonUploadBuilder, createUploadBuilder, createUrlUploadBuilder } from "./builder.js";
+import { createListBuilder } from "./list-builder.js";
+import { CID } from "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 createUploadBuilder(pinner, file);
+			},
+			fileArray(files) {
+				return createFileArrayUploadBuilder(pinner, files);
+			},
+			json(data) {
+				return createJsonUploadBuilder(pinner, data);
+			},
+			base64(base64String) {
+				return createBase64UploadBuilder(pinner, base64String);
+			},
+			url(urlString) {
+				return createUrlUploadBuilder(pinner, urlString);
+			},
+			cid(cidString) {
+				return createCidUploadBuilder(pinner, cidString);
+			}
+		},
+		async pinByHash(cid, options) {
+			const cidObj = 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 = 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 = CID.parse(cid);
+			return pinner.isPinned(cidObj);
+		},
+		async setPinMetadata(cid, metadata) {
+			const cidObj = CID.parse(cid);
+			await pinner.setPinMetadata(cidObj, metadata);
+		},
+		files: {
+			list() {
+				return 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
+export { pinataAdapter };
+//# sourceMappingURL=adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","names":[],"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,WAAO,oBAAoB,QAAQ,KAAK;;GAE1C,UAAU,OAAwD;AAChE,WAAO,6BAA6B,QAAQ,MAAM;;GAEpD,KAAK,MAAuD;AAC1D,WAAO,wBAAwB,QAAQ,KAAK;;GAE9C,OAAO,cAA+D;AACpE,WAAO,0BAA0B,QAAQ,aAAa;;GAExD,IAAI,WAA4D;AAC9D,WAAO,uBAAuB,QAAQ,UAAU;;GAElD,IAAI,WAA8C;AAChD,WAAO,uBAAuB,QAAQ,UAAU;;GAEnD;EAED,MAAM,UAAU,KAAa,SAA2C;GACtE,MAAM,SAAS,IAAI,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,SAAS,IAAI,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,SAAS,IAAI,MAAM,IAAI;AAC7B,UAAO,OAAO,SAAS,OAAO;;EAGhC,MAAM,eACJ,KACA,UACe;GACf,MAAM,SAAS,IAAI,MAAM,IAAI;AAC7B,SAAM,OAAO,eAAe,QAAQ,SAAS;;EAG/C,OAAO;GACL,OAAwC;AACtC,WAAO,kBAAkB,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"}

package/dist/esm/adapters/pinata/builder.d.ts

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