@lumeweb/pinner 0.0.1 → 0.1.1

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

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

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

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

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

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

package/dist/esm/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