@lumeweb/pinner 0.0.1 → 0.1.0

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

@@ -0,0 +1,187 @@
+import { jsonToFile } from "../../encoder/json.js";
+import { base64ToFile } from "../../encoder/base64.js";
+import { urlToFile } from "../../encoder/url.js";
+import "../../encoder/index.js";
+import { validateUrl } from "../../utils/validation.js";
+import { CID } from "multiformats/cid";
+
+//#region src/adapters/pinata/builder.ts
+/**
+* Error wrapper for Pinata adapter operations.
+*/
+var PinataAdapterError = class extends Error {
+	code;
+	cause;
+	constructor(message, code, cause) {
+		super(message);
+		this.name = "PinataAdapterError";
+		this.code = code;
+		this.cause = cause;
+	}
+};
+/**
+* Base upload builder with common name/keyvalues functionality.
+*/
+var BaseUploadBuilder = class {
+	_name;
+	_keyvalues;
+	constructor(pinner) {
+		this.pinner = pinner;
+	}
+	name(name) {
+		this._name = name;
+		return this;
+	}
+	keyvalues(kv) {
+		this._keyvalues = kv;
+		return this;
+	}
+	toUploadResult(result) {
+		return {
+			IpfsHash: result.cid,
+			PinSize: result.size,
+			Timestamp: result.createdAt.toISOString(),
+			isDuplicate: false
+		};
+	}
+};
+/**
+* File upload builder.
+*/
+var FileUploadBuilder = class extends BaseUploadBuilder {
+	constructor(pinner, file) {
+		super(pinner);
+		this.file = file;
+	}
+	async execute() {
+		const result = await this.pinner.uploadAndWait(this.file, {
+			name: this._name,
+			keyvalues: this._keyvalues
+		});
+		return this.toUploadResult(result);
+	}
+};
+/**
+* File array upload builder.
+*/
+var FileArrayUploadBuilder = class extends BaseUploadBuilder {
+	constructor(pinner, files) {
+		super(pinner);
+		this.files = files;
+		if (files.length === 0) throw new PinataAdapterError("Cannot upload empty file array", "EMPTY_FILE_ARRAY");
+	}
+	async execute() {
+		try {
+			const result = await (await this.pinner.uploadDirectory(this.files, {
+				name: this._name,
+				keyvalues: this._keyvalues
+			})).result;
+			return this.toUploadResult(result);
+		} catch (error) {
+			if (error instanceof Error) throw new PinataAdapterError(`File array upload failed: ${error.message}`, "UPLOAD_FAILED", error);
+			throw error;
+		}
+	}
+};
+/**
+* Encoded upload builder - handles JSON, Base64, and URL uploads using encoders.
+*/
+var EncodedUploadBuilder = class extends BaseUploadBuilder {
+	constructor(pinner, encoderFn) {
+		super(pinner);
+		this.encoderFn = encoderFn;
+	}
+	async execute() {
+		try {
+			const encoded = await this.encoderFn(this._name, this._keyvalues);
+			const result = await this.pinner.uploadAndWait(encoded.file, encoded.options);
+			return this.toUploadResult(result);
+		} catch (error) {
+			if (error instanceof Error) throw new PinataAdapterError(`Upload failed: ${error.message}`, "UPLOAD_FAILED", error);
+			throw error;
+		}
+	}
+};
+/**
+* CID upload builder (pin by CID).
+*/
+var CidUploadBuilder = class {
+	_name;
+	_keyvalues;
+	constructor(pinner, cidString) {
+		this.pinner = pinner;
+		this.cidString = cidString;
+	}
+	name(name) {
+		this._name = name;
+		return this;
+	}
+	keyvalues(kv) {
+		this._keyvalues = kv;
+		return this;
+	}
+	async execute() {
+		try {
+			const cid = CID.parse(this.cidString);
+			const generator = await this.pinner.pinByHash(cid, {
+				name: this._name,
+				metadata: this._keyvalues
+			});
+			for await (const _ of generator);
+		} catch (error) {
+			if (error instanceof Error) throw new PinataAdapterError(`CID upload failed: ${error.message}`, "INVALID_CID", error);
+			throw error;
+		}
+	}
+};
+/**
+* Create a file upload builder.
+*/
+function createUploadBuilder(pinner, file) {
+	return new FileUploadBuilder(pinner, file);
+}
+/**
+* Create a file array upload builder.
+*/
+function createFileArrayUploadBuilder(pinner, files) {
+	return new FileArrayUploadBuilder(pinner, files);
+}
+/**
+* Create a JSON upload builder.
+*/
+function createJsonUploadBuilder(pinner, data) {
+	return new EncodedUploadBuilder(pinner, (name, keyvalues) => jsonToFile(data, {
+		name,
+		keyvalues
+	}));
+}
+/**
+* Create a base64 upload builder.
+*/
+function createBase64UploadBuilder(pinner, base64String) {
+	return new EncodedUploadBuilder(pinner, (name, keyvalues) => base64ToFile(base64String, {
+		name,
+		keyvalues
+	}));
+}
+/**
+* Create a URL upload builder.
+*/
+function createUrlUploadBuilder(pinner, urlString, options) {
+	validateUrl(urlString);
+	return new EncodedUploadBuilder(pinner, (name, keyvalues) => urlToFile(urlString, {
+		name,
+		keyvalues,
+		fetch: options?.fetch
+	}));
+}
+/**
+* Create a CID upload builder.
+*/
+function createCidUploadBuilder(pinner, cidString) {
+	return new CidUploadBuilder(pinner, cidString);
+}
+
+//#endregion
+export { PinataAdapterError, createBase64UploadBuilder, createCidUploadBuilder, createFileArrayUploadBuilder, createJsonUploadBuilder, createUploadBuilder, createUrlUploadBuilder };
+//# sourceMappingURL=builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","names":[],"sources":["../../../../src/adapters/pinata/builder.ts"],"sourcesContent":["import type { Pinner } from \"@/pinner\";\nimport type {\n  PinataUploadBuilder,\n  PinataUploadResult,\n  UrlUploadBuilderOptions,\n} from \"@/types/pinata\";\nimport type { UploadOptions } from \"@/encoder/types\";\nimport { CID } from \"multiformats/cid\";\nimport { base64ToFile, jsonToFile, urlToFile } from \"@/encoder\";\nimport { validateUrl } from \"@/utils/validation\";\n\n/**\n * Error wrapper for Pinata adapter operations.\n */\nexport class PinataAdapterError extends Error {\n  code: \"UPLOAD_FAILED\" | \"EMPTY_FILE_ARRAY\" | \"INVALID_CID\";\n  cause?: Error;\n\n  constructor(\n    message: string,\n    code: PinataAdapterError[\"code\"],\n    cause?: Error,\n  ) {\n    super(message);\n    this.name = \"PinataAdapterError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\n/**\n * Base upload builder with common name/keyvalues functionality.\n */\nabstract class BaseUploadBuilder<\n  TResult,\n> implements PinataUploadBuilder<TResult> {\n  protected _name?: string;\n  protected _keyvalues?: Record<string, string>;\n\n  constructor(protected pinner: Pinner) {}\n\n  name(name: string): this {\n    this._name = name;\n    return this;\n  }\n\n  keyvalues(kv: Record<string, string>): this {\n    this._keyvalues = kv;\n    return this;\n  }\n\n  abstract execute(): Promise<TResult>;\n\n  protected toUploadResult(result: {\n    cid: string;\n    size: number;\n    createdAt: Date;\n  }): PinataUploadResult {\n    return {\n      IpfsHash: result.cid,\n      PinSize: result.size,\n      Timestamp: result.createdAt.toISOString(),\n      isDuplicate: false,\n    };\n  }\n}\n\n/**\n * File upload builder.\n */\nclass FileUploadBuilder extends BaseUploadBuilder<PinataUploadResult> {\n  constructor(\n    pinner: Pinner,\n    private file: File,\n  ) {\n    super(pinner);\n  }\n\n  async execute(): Promise<PinataUploadResult> {\n    const result = await this.pinner.uploadAndWait(this.file, {\n      name: this._name,\n      keyvalues: this._keyvalues,\n    });\n    return this.toUploadResult(result);\n  }\n}\n\n/**\n * File array upload builder.\n */\nclass FileArrayUploadBuilder extends BaseUploadBuilder<PinataUploadResult> {\n  constructor(\n    pinner: Pinner,\n    private files: File[],\n  ) {\n    super(pinner);\n    if (files.length === 0) {\n      throw new PinataAdapterError(\n        \"Cannot upload empty file array\",\n        \"EMPTY_FILE_ARRAY\",\n      );\n    }\n  }\n\n  async execute(): Promise<PinataUploadResult> {\n    try {\n      const operation = await this.pinner.uploadDirectory(this.files, {\n        name: this._name,\n        keyvalues: this._keyvalues,\n      });\n      const result = await operation.result;\n      return this.toUploadResult(result);\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new PinataAdapterError(\n          `File array upload failed: ${error.message}`,\n          \"UPLOAD_FAILED\",\n          error,\n        );\n      }\n      throw error;\n    }\n  }\n}\n\n/**\n * Encoded upload builder - handles JSON, Base64, and URL uploads using encoders.\n */\nclass EncodedUploadBuilder extends BaseUploadBuilder<PinataUploadResult> {\n  constructor(\n    pinner: Pinner,\n    private encoderFn: (\n      name?: string,\n      keyvalues?: Record<string, string>,\n    ) => Promise<{ file: File; options: UploadOptions }>,\n  ) {\n    super(pinner);\n  }\n\n  async execute(): Promise<PinataUploadResult> {\n    try {\n      const encoded = await this.encoderFn(this._name, this._keyvalues);\n      const result = await this.pinner.uploadAndWait(\n        encoded.file,\n        encoded.options,\n      );\n      return this.toUploadResult(result);\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new PinataAdapterError(\n          `Upload failed: ${error.message}`,\n          \"UPLOAD_FAILED\",\n          error,\n        );\n      }\n      throw error;\n    }\n  }\n}\n\n/**\n * CID upload builder (pin by CID).\n */\nclass CidUploadBuilder implements PinataUploadBuilder<void> {\n  private _name?: string;\n  private _keyvalues?: Record<string, string>;\n\n  constructor(\n    private pinner: Pinner,\n    private cidString: string,\n  ) {}\n\n  name(name: string): this {\n    this._name = name;\n    return this;\n  }\n\n  keyvalues(kv: Record<string, string>): this {\n    this._keyvalues = kv;\n    return this;\n  }\n\n  async execute(): Promise<void> {\n    try {\n      const cid = CID.parse(this.cidString);\n      const generator = await this.pinner.pinByHash(cid, {\n        name: this._name,\n        metadata: this._keyvalues,\n      });\n      for await (const _ of generator) {\n        // Pin operation in progress\n      }\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new PinataAdapterError(\n          `CID upload failed: ${error.message}`,\n          \"INVALID_CID\",\n          error,\n        );\n      }\n      throw error;\n    }\n  }\n}\n\n/**\n * Create a file upload builder.\n */\nexport function createUploadBuilder(\n  pinner: Pinner,\n  file: File,\n): PinataUploadBuilder<PinataUploadResult> {\n  return new FileUploadBuilder(pinner, file);\n}\n\n/**\n * Create a file array upload builder.\n */\nexport function createFileArrayUploadBuilder(\n  pinner: Pinner,\n  files: File[],\n): PinataUploadBuilder<PinataUploadResult> {\n  return new FileArrayUploadBuilder(pinner, files);\n}\n\n/**\n * Create a JSON upload builder.\n */\nexport function createJsonUploadBuilder(\n  pinner: Pinner,\n  data: object,\n): PinataUploadBuilder<PinataUploadResult> {\n  return new EncodedUploadBuilder(pinner, (name, keyvalues) =>\n    jsonToFile(data, { name, keyvalues }),\n  );\n}\n\n/**\n * Create a base64 upload builder.\n */\nexport function createBase64UploadBuilder(\n  pinner: Pinner,\n  base64String: string,\n): PinataUploadBuilder<PinataUploadResult> {\n  return new EncodedUploadBuilder(pinner, (name, keyvalues) =>\n    base64ToFile(base64String, { name, keyvalues }),\n  );\n}\n\n/**\n * Create a URL upload builder.\n */\nexport function createUrlUploadBuilder(\n  pinner: Pinner,\n  urlString: string,\n  options?: UrlUploadBuilderOptions,\n): PinataUploadBuilder<PinataUploadResult> {\n  // Validate URL to prevent SSRF attacks\n  validateUrl(urlString);\n\n  return new EncodedUploadBuilder(pinner, (name, keyvalues) =>\n    urlToFile(urlString, { name, keyvalues, fetch: options?.fetch }),\n  );\n}\n\n/**\n * Create a CID upload builder.\n */\nexport function createCidUploadBuilder(\n  pinner: Pinner,\n  cidString: string,\n): PinataUploadBuilder<void> {\n  return new CidUploadBuilder(pinner, cidString);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+import { PinByHashOptions, PinataFile, PinataListBuilder, PinataMetadata, PinataMetadataOptions, PinataPin, PinataUploadBuilder, PinataUploadResult } from "../../types/pinata.js";
+import { PinataAdapter, pinataAdapter } from "./adapter.js";
+import "./builder.js";
+import "./list-builder.js";

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

@@ -0,0 +1,3 @@
+import { PinataAdapterError } from "./builder.js";
+import { createListBuilder } from "./list-builder.js";
+import { pinataAdapter } from "./adapter.js";

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

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

package/dist/esm/adapters/pinata/list-builder.js

@@ -0,0 +1,51 @@
+//#region src/adapters/pinata/list-builder.ts
+/**
+* List builder for listing pins.
+*
+* Note: .pageToken() provides Pinata SDK API compatibility for easier migration.
+* The token is passed through to the underlying IPFS Pinning Service cursor parameter.
+* The server handles the actual pagination logic according to the IPFS Pinning Service spec.
+*/
+var PinataListBuilderImpl = class {
+	_limit;
+	_pageToken;
+	_offset;
+	constructor(pinner) {
+		this.pinner = pinner;
+	}
+	limit(limit) {
+		this._limit = limit;
+		return this;
+	}
+	offset(offset) {
+		this._offset = offset;
+		return this;
+	}
+	pageToken(pageToken) {
+		this._pageToken = pageToken;
+		return this;
+	}
+	async execute() {
+		const options = {};
+		if (this._limit !== void 0) options.limit = this._limit;
+		if (this._pageToken !== void 0) options.cursor = this._pageToken;
+		return (await this.pinner.listPins(options)).map((pin) => ({
+			id: pin.cid.toString(),
+			ipfsPinHash: pin.cid.toString(),
+			size: pin.size || 0,
+			name: pin.name || "",
+			cid: pin.cid.toString(),
+			createdAt: pin.created.toISOString()
+		}));
+	}
+};
+/**
+* Create a list builder.
+*/
+function createListBuilder(pinner) {
+	return new PinataListBuilderImpl(pinner);
+}
+
+//#endregion
+export { createListBuilder };
+//# sourceMappingURL=list-builder.js.map

package/dist/esm/adapters/pinata/list-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-builder.js","names":[],"sources":["../../../../src/adapters/pinata/list-builder.ts"],"sourcesContent":["import type { Pinner } from \"@/pinner\";\nimport type { PinataFile, PinataListBuilder } from \"@/types/pinata\";\nimport type { RemoteLsOptions } from \"@/types/pin\";\n\n/**\n * List builder for listing pins.\n *\n * Note: .pageToken() provides Pinata SDK API compatibility for easier migration.\n * The token is passed through to the underlying IPFS Pinning Service cursor parameter.\n * The server handles the actual pagination logic according to the IPFS Pinning Service spec.\n */\nclass PinataListBuilderImpl implements PinataListBuilder<PinataFile[]> {\n  private _limit?: number;\n  private _pageToken?: string;\n  private _offset?: number;\n\n  constructor(private pinner: Pinner) {}\n\n  limit(limit: number): this {\n    this._limit = limit;\n    return this;\n  }\n\n  offset(offset: number): this {\n    this._offset = offset;\n    return this;\n  }\n\n  pageToken(pageToken: string): this {\n    this._pageToken = pageToken;\n    return this;\n  }\n\n  async execute(): Promise<PinataFile[]> {\n    const options: RemoteLsOptions = {};\n\n    if (this._limit !== undefined) {\n      options.limit = this._limit;\n    }\n\n    if (this._pageToken !== undefined) {\n      options.cursor = this._pageToken;\n    }\n\n    const remotePins = await this.pinner.listPins(options);\n\n    return remotePins.map((pin) => ({\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 * Create a list builder.\n */\nexport function createListBuilder(\n  pinner: Pinner,\n): PinataListBuilder<PinataFile[]> {\n  return new PinataListBuilderImpl(pinner);\n}\n"],"mappings":";;;;;;;;AAWA,IAAM,wBAAN,MAAuE;CACrE,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YAAY,AAAQ,QAAgB;EAAhB;;CAEpB,MAAM,OAAqB;AACzB,OAAK,SAAS;AACd,SAAO;;CAGT,OAAO,QAAsB;AAC3B,OAAK,UAAU;AACf,SAAO;;CAGT,UAAU,WAAyB;AACjC,OAAK,aAAa;AAClB,SAAO;;CAGT,MAAM,UAAiC;EACrC,MAAM,UAA2B,EAAE;AAEnC,MAAI,KAAK,WAAW,OAClB,SAAQ,QAAQ,KAAK;AAGvB,MAAI,KAAK,eAAe,OACtB,SAAQ,SAAS,KAAK;AAKxB,UAFmB,MAAM,KAAK,OAAO,SAAS,QAAQ,EAEpC,KAAK,SAAS;GAC9B,IAAI,IAAI,IAAI,UAAU;GACtB,aAAa,IAAI,IAAI,UAAU;GAC/B,MAAM,IAAI,QAAQ;GAClB,MAAM,IAAI,QAAQ;GAClB,KAAK,IAAI,IAAI,UAAU;GACvB,WAAW,IAAI,QAAQ,aAAa;GACrC,EAAE;;;;;;AAOP,SAAgB,kBACd,QACiC;AACjC,QAAO,IAAI,sBAAsB,OAAO"}

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

@@ -0,0 +1,2 @@
+import { UnstorageBlockstoreOptions, setDriverFactory } from "./unstorage-base.js";
+import { createBlockstore, createDatastore } from "./unstorage.js";

package/dist/esm/blockstore/index.js

@@ -0,0 +1,2 @@
+import { setDriverFactory } from "./unstorage-base.js";
+import { createBlockstore, createDatastore } from "./unstorage.js";

package/dist/esm/blockstore/unstorage-base.d.ts

@@ -0,0 +1,23 @@
+import { Driver, Storage } from "unstorage";
+import { Datastore } from "interface-datastore";
+
+//#region src/blockstore/unstorage-base.d.ts
+interface UnstorageBlockstoreOptions {
+  storage?: Storage;
+  prefix?: string;
+  driver?: Driver;
+  base?: string;
+  datastorePrefix?: string;
+}
+/**
+ * prefix: Key prefix for blockstore keys (e.g., "blockstore" or "pinner-helia-blocks").
+ *         This is prepended to CID strings in storage keys.
+ *
+ * base: Base path for the storage driver (e.g., "pinner:" for IndexedDB, "./.pinner-blocks" for filesystem).
+ *       This determines where the storage driver stores data.
+ */
+type DriverFactory = () => Driver | Promise<Driver>;
+declare function setDriverFactory(factory: DriverFactory | null): void;
+//#endregion
+export { UnstorageBlockstoreOptions, setDriverFactory };
+//# sourceMappingURL=unstorage-base.d.ts.map

package/dist/esm/blockstore/unstorage-base.js

@@ -0,0 +1,231 @@
+import { collectAsyncIterable } from "../utils/stream.js";
+import { DEFAULT_BLOCKSTORE_PREFIX } from "../types/constants.js";
+import { BaseBlockstore } from "/home/runner/work/web/web/node_modules/.pnpm/blockstore-core@6.1.2/node_modules/blockstore-core/dist/src/index.js";
+import { CID } from "multiformats/cid";
+import { createStorage } from "unstorage";
+import { Key } from "interface-datastore";
+
+//#region src/blockstore/unstorage-base.ts
+let driverFactory = null;
+function setDriverFactory(factory) {
+	driverFactory = factory;
+}
+function createStorageWithOptions(options) {
+	return options.storage ? options.storage : createStorage({ driver: options.driver });
+}
+async function initializeStorage(storage, options, getDefaultDriver) {
+	if (options.storage || options.driver) return;
+	const driver = await getDefaultDriver(options.base);
+	Object.assign(storage, createStorage({ driver }));
+}
+function createUnstorageBase(options, getDefaultDriver) {
+	const storage = createStorageWithOptions(options);
+	const initialized = initializeStorage(storage, options, getDefaultDriver);
+	async function ensureInitialized() {
+		await initialized;
+	}
+	async function hasItem(key) {
+		await ensureInitialized();
+		return await storage.hasItem(key);
+	}
+	async function getItem(key) {
+		await ensureInitialized();
+		const value = await storage.getItemRaw(key);
+		if (value === null) throw new Error(`Item not found: ${key}`);
+		return value;
+	}
+	async function putItem(key, value) {
+		await ensureInitialized();
+		await storage.setItemRaw(key, value);
+	}
+	async function deleteItem(key) {
+		await ensureInitialized();
+		await storage.removeItem(key);
+	}
+	async function getAllKeys() {
+		await ensureInitialized();
+		return await storage.getKeys();
+	}
+	return {
+		storage,
+		hasItem,
+		getItem,
+		putItem,
+		deleteItem,
+		getAllKeys
+	};
+}
+function createUnstorageBlockstore(getDefaultDriver) {
+	return class UnstorageBlockstore extends BaseBlockstore {
+		prefix;
+		base;
+		constructor(options = {}) {
+			super();
+			this.prefix = options.prefix ?? DEFAULT_BLOCKSTORE_PREFIX;
+			this.base = createUnstorageBase(options, getDefaultDriver);
+		}
+		keyToStorageKey(key) {
+			return `${this.prefix}:${key.toString()}`;
+		}
+		async has(key, _) {
+			return await this.base.hasItem(this.keyToStorageKey(key));
+		}
+		async put(key, val, _) {
+			const storageKey = this.keyToStorageKey(key);
+			const bytes = val instanceof Uint8Array ? val : await collectAsyncIterable(val);
+			await this.base.putItem(storageKey, bytes);
+			return key;
+		}
+		async *putMany(source, options) {
+			for await (const { cid, bytes } of source) yield await this.put(cid, bytes, options);
+		}
+		async *get(key, _) {
+			const storageKey = this.keyToStorageKey(key);
+			yield await this.base.getItem(storageKey);
+		}
+		async *getMany(source, options) {
+			for await (const cid of source) yield {
+				cid,
+				bytes: async function* () {
+					yield* await this.get(cid, options);
+				}.call(this)
+			};
+		}
+		async delete(key, _) {
+			await this.base.deleteItem(this.keyToStorageKey(key));
+		}
+		async *deleteMany(source, options) {
+			for await (const cid of source) {
+				await this.delete(cid, options);
+				yield cid;
+			}
+		}
+		async *getAll(_) {
+			const keys = await this.base.getAllKeys();
+			for (const key of keys) if (key.startsWith(this.prefix + ":")) {
+				const cidString = key.slice(this.prefix.length + 1);
+				try {
+					const cid = CID.parse(cidString);
+					const value = await this.base.getItem(key);
+					yield {
+						cid,
+						bytes: (async function* () {
+							yield value;
+						})()
+					};
+				} catch {}
+			}
+		}
+	};
+}
+function createUnstorageDatastore(getDefaultDriver) {
+	return class UnstorageDatastore {
+		prefix;
+		base;
+		constructor(options = {}) {
+			this.prefix = options.datastorePrefix ?? options.prefix ?? DEFAULT_BLOCKSTORE_PREFIX;
+			this.base = createUnstorageBase(options, getDefaultDriver);
+		}
+		keyToStorageKey(key) {
+			return `${this.prefix}:${key.toString()}`;
+		}
+		storageKeyToKey(storageKey) {
+			return new Key(storageKey.slice(this.prefix.length + 1));
+		}
+		async has(key, _) {
+			return await this.base.hasItem(this.keyToStorageKey(key));
+		}
+		async put(key, val, _) {
+			await this.base.putItem(this.keyToStorageKey(key), val);
+			return key;
+		}
+		async *putMany(source, options) {
+			for await (const { key, value } of source) yield await this.put(key, value, options);
+		}
+		async get(key, _) {
+			const storageKey = this.keyToStorageKey(key);
+			try {
+				return await this.base.getItem(storageKey);
+			} catch (error) {
+				throw new Error(`Datastore item not found: ${key.toString()}`);
+			}
+		}
+		async *getMany(source, options) {
+			for await (const key of source) yield {
+				key,
+				value: await this.get(key, options)
+			};
+		}
+		async delete(key, _) {
+			await this.base.deleteItem(this.keyToStorageKey(key));
+		}
+		async *deleteMany(source, options) {
+			for await (const key of source) {
+				await this.delete(key, options);
+				yield key;
+			}
+		}
+		batch() {
+			const operations = [];
+			const base = this.base;
+			const keyToStorageKey = this.keyToStorageKey.bind(this);
+			return {
+				put(key, value) {
+					operations.push({
+						type: "put",
+						key,
+						value
+					});
+				},
+				delete(key) {
+					operations.push({
+						type: "delete",
+						key
+					});
+				},
+				async commit() {
+					for (const op of operations) if (op.type === "put" && op.value !== void 0) await base.putItem(keyToStorageKey(op.key), op.value);
+					else if (op.type === "delete") await base.deleteItem(keyToStorageKey(op.key));
+					operations.length = 0;
+				}
+			};
+		}
+		async *query(query, _) {
+			const keys = await this.base.getAllKeys();
+			for (const key of keys) {
+				if (!key.startsWith(this.prefix + ":")) continue;
+				const datastoreKey = this.storageKeyToKey(key);
+				if (query.prefix && !datastoreKey.toString().startsWith(query.prefix.toString())) continue;
+				const value = await this.base.getItem(key);
+				if (query.filters) {
+					let match = true;
+					for (const filter of query.filters) if (!filter({
+						key: datastoreKey,
+						value
+					})) {
+						match = false;
+						break;
+					}
+					if (!match) continue;
+				}
+				yield {
+					key: datastoreKey,
+					value
+				};
+			}
+		}
+		async *queryKeys(query, _) {
+			const keys = await this.base.getAllKeys();
+			for (const key of keys) {
+				if (!key.startsWith(this.prefix + ":")) continue;
+				const datastoreKey = this.storageKeyToKey(key);
+				if (query.prefix && !datastoreKey.toString().startsWith(query.prefix.toString())) continue;
+				yield datastoreKey;
+			}
+		}
+	};
+}
+
+//#endregion
+export { createUnstorageBlockstore, createUnstorageDatastore, driverFactory, setDriverFactory };
+//# sourceMappingURL=unstorage-base.js.map

package/dist/esm/blockstore/unstorage-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unstorage-base.js","names":[],"sources":["../../../src/blockstore/unstorage-base.ts"],"sourcesContent":["import { BaseBlockstore } from \"blockstore-core\";\nimport type { InputPair, Pair as BlockstorePair } from \"interface-blockstore\";\nimport type {\n  AbortOptions,\n  Await,\n  AwaitGenerator,\n  AwaitIterable,\n} from \"interface-store\";\nimport { CID } from \"multiformats/cid\";\nimport { createStorage, type Driver, type Storage } from \"unstorage\";\nimport { DEFAULT_BLOCKSTORE_PREFIX } from \"@/types/constants\";\nimport type { Batch, Datastore, KeyQuery, Query } from \"interface-datastore\";\nimport { Key, Pair } from \"interface-datastore\";\nimport { collectAsyncIterable } from \"@/utils/stream\";\n\n\n\nexport interface UnstorageBlockstoreOptions {\n  storage?: Storage;\n  prefix?: string;\n  driver?: Driver;\n  base?: string;\n  datastorePrefix?: string;\n}\n\n/**\n * prefix: Key prefix for blockstore keys (e.g., \"blockstore\" or \"pinner-helia-blocks\").\n *         This is prepended to CID strings in storage keys.\n *\n * base: Base path for the storage driver (e.g., \"pinner:\" for IndexedDB, \"./.pinner-blocks\" for filesystem).\n *       This determines where the storage driver stores data.\n */\n\ntype DriverFactory = () => Driver | Promise<Driver>;\n\nexport let driverFactory: DriverFactory | null = null;\n\nexport function setDriverFactory(factory: DriverFactory | null): void {\n  driverFactory = factory;\n}\n\nfunction createStorageWithOptions(\n  options: UnstorageBlockstoreOptions,\n): Storage {\n  return options.storage\n    ? options.storage\n    : createStorage({ driver: options.driver });\n}\n\nasync function initializeStorage(\n  storage: Storage,\n  options: UnstorageBlockstoreOptions,\n  getDefaultDriver: (base?: string) => Driver | Promise<Driver>,\n): Promise<void> {\n  if (options.storage || options.driver) {\n    return;\n  }\n\n  const driver = await getDefaultDriver(options.base);\n  Object.assign(storage, createStorage({ driver }));\n}\n\nfunction createUnstorageBase(\n  options: UnstorageBlockstoreOptions,\n  getDefaultDriver: (base?: string) => Driver | Promise<Driver>,\n) {\n  const storage = createStorageWithOptions(options);\n  const initialized = initializeStorage(storage, options, getDefaultDriver);\n\n  async function ensureInitialized(): Promise<void> {\n    await initialized;\n  }\n\n  async function hasItem(key: string): Promise<boolean> {\n    await ensureInitialized();\n    return await storage.hasItem(key);\n  }\n\n  async function getItem(key: string): Promise<Uint8Array> {\n    await ensureInitialized();\n    const value = await storage.getItemRaw<Uint8Array>(key);\n\n    if (value === null) {\n      throw new Error(`Item not found: ${key}`);\n    }\n\n    return value;\n  }\n\n  async function putItem(key: string, value: Uint8Array): Promise<void> {\n    await ensureInitialized();\n    await storage.setItemRaw(key, value);\n  }\n\n  async function deleteItem(key: string): Promise<void> {\n    await ensureInitialized();\n    await storage.removeItem(key);\n  }\n\n  async function getAllKeys(): Promise<string[]> {\n    await ensureInitialized();\n    return await storage.getKeys();\n  }\n\n  return {\n    storage,\n    hasItem,\n    getItem,\n    putItem,\n    deleteItem,\n    getAllKeys,\n  };\n}\n\nexport function createUnstorageBlockstore(\n  getDefaultDriver: (base?: string) => Driver | Promise<Driver>,\n): new (\n  options?: UnstorageBlockstoreOptions,\n) => InstanceType<typeof BaseBlockstore> {\n  return class UnstorageBlockstore extends BaseBlockstore {\n    private prefix: string;\n    private base: ReturnType<typeof createUnstorageBase>;\n\n    constructor(options: UnstorageBlockstoreOptions = {}) {\n      super();\n      this.prefix = options.prefix ?? DEFAULT_BLOCKSTORE_PREFIX;\n      this.base = createUnstorageBase(options, getDefaultDriver);\n    }\n\n    private keyToStorageKey(key: CID): string {\n      return `${this.prefix}:${key.toString()}`;\n    }\n\n    async has(key: CID, _?: AbortOptions): Promise<boolean> {\n      return await this.base.hasItem(this.keyToStorageKey(key));\n    }\n\n    async put(\n      key: CID,\n      val: Uint8Array | AwaitIterable<Uint8Array>,\n      _?: AbortOptions,\n    ): Promise<CID> {\n      const storageKey = this.keyToStorageKey(key);\n      const bytes =\n        val instanceof Uint8Array ? val : await collectAsyncIterable(val);\n      await this.base.putItem(storageKey, bytes);\n      return key;\n    }\n\n    async *putMany(\n      source: AwaitIterable<InputPair>,\n      options?: AbortOptions,\n    ): AwaitGenerator<CID> {\n      for await (const { cid, bytes } of source) {\n        yield await this.put(cid, bytes, options);\n      }\n    }\n\n    async *get(key: CID, _?: AbortOptions): AsyncGenerator<Uint8Array> {\n      const storageKey = this.keyToStorageKey(key);\n      const value = await this.base.getItem(storageKey);\n      yield value;\n    }\n\n    async *getMany(\n      source: AwaitIterable<CID>,\n      options?: AbortOptions,\n    ): AwaitGenerator<BlockstorePair> {\n      for await (const cid of source) {\n        yield {\n          cid,\n          bytes: (async function* () {\n            yield* await this.get(cid, options);\n          }.call(this)),\n        };\n      }\n    }\n\n    async delete(key: CID, _?: AbortOptions): Promise<void> {\n      await this.base.deleteItem(this.keyToStorageKey(key));\n    }\n\n    async *deleteMany(\n      source: AwaitIterable<CID>,\n      options?: AbortOptions,\n    ): AwaitGenerator<CID> {\n      for await (const cid of source) {\n        await this.delete(cid, options);\n        yield cid;\n      }\n    }\n\n    async *getAll(_?: AbortOptions): AwaitGenerator<BlockstorePair> {\n      const keys = await this.base.getAllKeys();\n\n      for (const key of keys) {\n        if (key.startsWith(this.prefix + \":\")) {\n          const cidString = key.slice(this.prefix.length + 1);\n          try {\n            const cid = CID.parse(cidString);\n            const value = await this.base.getItem(key);\n\n            yield {\n              cid,\n              bytes: (async function* () {\n                yield value;\n              })(),\n            };\n          } catch {\n            // Skip invalid keys\n          }\n        }\n      }\n    }\n  };\n}\n\nexport function createUnstorageDatastore(\n  getDefaultDriver: (base?: string) => Driver | Promise<Driver>,\n): new (options?: UnstorageBlockstoreOptions) => Datastore {\n  return class UnstorageDatastore implements Datastore {\n    private prefix: string;\n    private base: ReturnType<typeof createUnstorageBase>;\n\n    constructor(options: UnstorageBlockstoreOptions = {}) {\n      this.prefix =\n        options.datastorePrefix ?? options.prefix ?? DEFAULT_BLOCKSTORE_PREFIX;\n      this.base = createUnstorageBase(options, getDefaultDriver);\n    }\n\n    private keyToStorageKey(key: Key): string {\n      return `${this.prefix}:${key.toString()}`;\n    }\n\n    private storageKeyToKey(storageKey: string): Key {\n      return new Key(storageKey.slice(this.prefix.length + 1));\n    }\n\n    async has(key: Key, _?: AbortOptions): Promise<boolean> {\n      return await this.base.hasItem(this.keyToStorageKey(key));\n    }\n\n    async put(key: Key, val: Uint8Array, _?: AbortOptions): Promise<Key> {\n      await this.base.putItem(this.keyToStorageKey(key), val);\n      return key;\n    }\n\n    async *putMany(\n      source: AwaitIterable<Pair>,\n      options?: AbortOptions,\n    ): AsyncGenerator<Key> {\n      for await (const { key, value } of source) {\n        yield await this.put(key, value, options);\n      }\n    }\n\n    async get(key: Key, _?: AbortOptions): Promise<Uint8Array> {\n      const storageKey = this.keyToStorageKey(key);\n      try {\n        return await this.base.getItem(storageKey);\n      } catch (error) {\n        throw new Error(`Datastore item not found: ${key.toString()}`);\n      }\n    }\n\n    async *getMany(\n      source: AwaitIterable<Key>,\n      options?: AbortOptions,\n    ): AsyncGenerator<Pair> {\n      for await (const key of source) {\n        yield {\n          key,\n          value: await this.get(key, options),\n        };\n      }\n    }\n\n    async delete(key: Key, _?: AbortOptions): Promise<void> {\n      await this.base.deleteItem(this.keyToStorageKey(key));\n    }\n\n    async *deleteMany(\n      source: AwaitIterable<Key>,\n      options?: AbortOptions,\n    ): AsyncGenerator<Key> {\n      for await (const key of source) {\n        await this.delete(key, options);\n        yield key;\n      }\n    }\n\n    batch(): Batch {\n      const operations: Array<{\n        type: \"put\" | \"delete\";\n        key: Key;\n        value?: Uint8Array;\n      }> = [];\n      const base = this.base;\n      const keyToStorageKey = this.keyToStorageKey.bind(this);\n\n      return {\n        put(key: Key, value: Uint8Array): void {\n          operations.push({ type: \"put\", key, value });\n        },\n        delete(key: Key): void {\n          operations.push({ type: \"delete\", key });\n        },\n        async commit(): Promise<void> {\n          for (const op of operations) {\n            if (op.type === \"put\" && op.value !== undefined) {\n              await base.putItem(keyToStorageKey(op.key), op.value);\n            } else if (op.type === \"delete\") {\n              await base.deleteItem(keyToStorageKey(op.key));\n            }\n          }\n          operations.length = 0;\n        },\n      };\n    }\n\n    async *query(query: Query, _?: AbortOptions): AsyncGenerator<Pair> {\n      const keys = await this.base.getAllKeys();\n\n      for (const key of keys) {\n        if (!key.startsWith(this.prefix + \":\")) {\n          continue;\n        }\n\n        const datastoreKey = this.storageKeyToKey(key);\n\n        if (\n          query.prefix &&\n          !datastoreKey.toString().startsWith(query.prefix.toString())\n        ) {\n          continue;\n        }\n\n        const value = await this.base.getItem(key);\n\n        if (query.filters) {\n          let match = true;\n          for (const filter of query.filters) {\n            if (!filter({ key: datastoreKey, value })) {\n              match = false;\n              break;\n            }\n          }\n          if (!match) continue;\n        }\n\n        yield {\n          key: datastoreKey,\n          value,\n        };\n      }\n    }\n\n    async *queryKeys(query: KeyQuery, _?: AbortOptions): AsyncGenerator<Key> {\n      const keys = await this.base.getAllKeys();\n\n      for (const key of keys) {\n        if (!key.startsWith(this.prefix + \":\")) {\n          continue;\n        }\n\n        const datastoreKey = this.storageKeyToKey(key);\n\n        if (\n          query.prefix &&\n          !datastoreKey.toString().startsWith(query.prefix.toString())\n        ) {\n          continue;\n        }\n\n        yield datastoreKey;\n      }\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/esm/blockstore/unstorage.d.ts

@@ -0,0 +1,36 @@
+import { UnstorageBlockstoreOptions, setDriverFactory } from "./unstorage-base.js";
+import * as interface_datastore0 from "interface-datastore";
+import * as multiformats0 from "multiformats";
+import * as interface_store0 from "interface-store";
+import * as interface_blockstore0 from "interface-blockstore";
+
+//#region src/blockstore/unstorage.d.ts
+declare function createBlockstore(options?: UnstorageBlockstoreOptions): {
+  new (instanceOptions?: UnstorageBlockstoreOptions): {
+    has(key: multiformats0.CID, options?: interface_store0.AbortOptions): interface_store0.Await<boolean>;
+    put(key: multiformats0.CID, val: Uint8Array | interface_store0.AwaitIterable<Uint8Array>, options?: interface_store0.AbortOptions): interface_store0.Await<multiformats0.CID>;
+    putMany(source: interface_store0.AwaitIterable<interface_blockstore0.InputPair>, options?: interface_store0.AbortOptions): interface_store0.AwaitGenerator<multiformats0.CID>;
+    get(key: multiformats0.CID, options?: interface_store0.AbortOptions): interface_store0.AwaitGenerator<Uint8Array>;
+    getMany(source: interface_store0.AwaitIterable<multiformats0.CID>, options?: interface_store0.AbortOptions): interface_store0.AwaitGenerator<interface_blockstore0.Pair>;
+    delete(key: multiformats0.CID, options?: interface_store0.AbortOptions): interface_store0.Await<void>;
+    deleteMany(source: interface_store0.AwaitIterable<multiformats0.CID>, options?: interface_store0.AbortOptions): interface_store0.AwaitGenerator<multiformats0.CID>;
+    getAll(options?: interface_store0.AbortOptions): interface_store0.AwaitGenerator<interface_blockstore0.Pair>;
+  };
+};
+declare function createDatastore(options?: UnstorageBlockstoreOptions): {
+  new (instanceOptions?: UnstorageBlockstoreOptions): {
+    batch(): interface_datastore0.Batch<{}>;
+    query(query: interface_datastore0.Query, options?: interface_store0.AbortOptions | undefined): interface_store0.AwaitGenerator<interface_datastore0.Pair>;
+    queryKeys(query: interface_datastore0.KeyQuery, options?: interface_store0.AbortOptions | undefined): interface_store0.AwaitGenerator<interface_datastore0.Key>;
+    has(key: interface_datastore0.Key, options?: interface_store0.AbortOptions | undefined): interface_store0.Await<boolean>;
+    put(key: interface_datastore0.Key, val: Uint8Array<ArrayBufferLike>, options?: interface_store0.AbortOptions | undefined): interface_store0.Await<interface_datastore0.Key>;
+    putMany(source: interface_store0.AwaitIterable<interface_datastore0.Pair>, options?: interface_store0.AbortOptions | undefined): interface_store0.AwaitGenerator<interface_datastore0.Key, any, any>;
+    get(key: interface_datastore0.Key, options?: interface_store0.AbortOptions | undefined): interface_store0.Await<Uint8Array<ArrayBufferLike>>;
+    getMany(source: interface_store0.AwaitIterable<interface_datastore0.Key>, options?: interface_store0.AbortOptions | undefined): interface_store0.AwaitGenerator<interface_datastore0.Pair, any, any>;
+    delete(key: interface_datastore0.Key, options?: interface_store0.AbortOptions | undefined): interface_store0.Await<void>;
+    deleteMany(source: interface_store0.AwaitIterable<interface_datastore0.Key>, options?: interface_store0.AbortOptions | undefined): interface_store0.AwaitGenerator<interface_datastore0.Key, any, any>;
+  };
+};
+//#endregion
+export { createBlockstore, createDatastore };
+//# sourceMappingURL=unstorage.d.ts.map

package/dist/esm/blockstore/unstorage.js

@@ -0,0 +1,38 @@
+import { DEFAULT_BLOCKSTORE_BASE, DEFAULT_BLOCKSTORE_FS_BASE } from "../types/constants.js";
+import { createUnstorageBlockstore, createUnstorageDatastore, driverFactory, setDriverFactory } from "./unstorage-base.js";
+
+//#region src/blockstore/unstorage.ts
+function isBrowser() {
+	return typeof window !== "undefined" && typeof window.localStorage !== "undefined";
+}
+async function getDefaultDriver(base) {
+	if (driverFactory) return await driverFactory();
+	if (isBrowser()) return (await import("unstorage/drivers/indexedb")).default({ base: base ?? DEFAULT_BLOCKSTORE_BASE });
+	else return (await import("unstorage/drivers/fs-lite")).default({ base: base ?? DEFAULT_BLOCKSTORE_FS_BASE });
+}
+function createBlockstore(options) {
+	const BlockstoreClass = createUnstorageBlockstore(getDefaultDriver);
+	return class extends BlockstoreClass {
+		constructor(instanceOptions) {
+			super({
+				...options,
+				...instanceOptions
+			});
+		}
+	};
+}
+function createDatastore(options) {
+	const DatastoreClass = createUnstorageDatastore(getDefaultDriver);
+	return class extends DatastoreClass {
+		constructor(instanceOptions) {
+			super({
+				...options,
+				...instanceOptions
+			});
+		}
+	};
+}
+
+//#endregion
+export { createBlockstore, createDatastore };
+//# sourceMappingURL=unstorage.js.map

package/dist/esm/blockstore/unstorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unstorage.js","names":[],"sources":["../../../src/blockstore/unstorage.ts"],"sourcesContent":["import {\n  createUnstorageBlockstore,\n  createUnstorageDatastore,\n  driverFactory,\n  setDriverFactory,\n  type UnstorageBlockstoreOptions,\n} from \"./unstorage-base\";\nimport {\n  DEFAULT_BLOCKSTORE_BASE,\n  DEFAULT_BLOCKSTORE_FS_BASE,\n} from \"@/types/constants\";\n\nfunction isBrowser(): boolean {\n  return (\n    typeof window !== \"undefined\" && typeof window.localStorage !== \"undefined\"\n  );\n}\n\nasync function getDefaultDriver(base?: string) {\n  // Use driverFactory override if set (typically by tests to inject in-memory driver)\n  if (driverFactory) {\n    return await driverFactory();\n  }\n\n  if (isBrowser()) {\n    return (await import(\"unstorage/drivers/indexedb\")).default({\n      base: base ?? DEFAULT_BLOCKSTORE_BASE,\n    });\n  } else {\n    return (await import(\"unstorage/drivers/fs-lite\")).default({\n      base: base ?? DEFAULT_BLOCKSTORE_FS_BASE,\n    });\n  }\n}\n\nexport function createBlockstore(options?: UnstorageBlockstoreOptions) {\n  const BlockstoreClass = createUnstorageBlockstore(getDefaultDriver);\n  return class extends BlockstoreClass {\n    constructor(instanceOptions?: UnstorageBlockstoreOptions) {\n      super({ ...options, ...instanceOptions });\n    }\n  };\n}\n\nexport function createDatastore(options?: UnstorageBlockstoreOptions) {\n  const DatastoreClass = createUnstorageDatastore(getDefaultDriver);\n  return class extends DatastoreClass {\n    constructor(instanceOptions?: UnstorageBlockstoreOptions) {\n      super({ ...options, ...instanceOptions });\n    }\n  };\n}\n\nexport { setDriverFactory };\nexport type { UnstorageBlockstoreOptions } from \"./unstorage-base\";\n"],"mappings":";;;;AAYA,SAAS,YAAqB;AAC5B,QACE,OAAO,WAAW,eAAe,OAAO,OAAO,iBAAiB;;AAIpE,eAAe,iBAAiB,MAAe;AAE7C,KAAI,cACF,QAAO,MAAM,eAAe;AAG9B,KAAI,WAAW,CACb,SAAQ,MAAM,OAAO,+BAA+B,QAAQ,EAC1D,MAAM,QAAQ,yBACf,CAAC;KAEF,SAAQ,MAAM,OAAO,8BAA8B,QAAQ,EACzD,MAAM,QAAQ,4BACf,CAAC;;AAIN,SAAgB,iBAAiB,SAAsC;CACrE,MAAM,kBAAkB,0BAA0B,iBAAiB;AACnE,QAAO,cAAc,gBAAgB;EACnC,YAAY,iBAA8C;AACxD,SAAM;IAAE,GAAG;IAAS,GAAG;IAAiB,CAAC;;;;AAK/C,SAAgB,gBAAgB,SAAsC;CACpE,MAAM,iBAAiB,yBAAyB,iBAAiB;AACjE,QAAO,cAAc,eAAe;EAClC,YAAY,iBAA8C;AACxD,SAAM;IAAE,GAAG;IAAS,GAAG;IAAiB,CAAC"}