@lumeweb/pinner 0.0.1 → 0.1.0

package/dist/cjs/blockstore/unstorage-base.cjs

@@ -0,0 +1,240 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_stream = require('../utils/stream.cjs');
+const require_constants = require('../types/constants.cjs');
+let _home_runner_work_web_web_node_modules__pnpm_blockstore_core_6_1_2_node_modules_blockstore_core_dist_src_index_js = require("/home/runner/work/web/web/node_modules/.pnpm/blockstore-core@6.1.2/node_modules/blockstore-core/dist/src/index.js");
+let multiformats_cid = require("multiformats/cid");
+let unstorage = require("unstorage");
+let interface_datastore = require("interface-datastore");
+
+//#region src/blockstore/unstorage-base.ts
+let driverFactory = null;
+function setDriverFactory(factory) {
+	driverFactory = factory;
+}
+function createStorageWithOptions(options) {
+	return options.storage ? options.storage : (0, unstorage.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, (0, unstorage.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 _home_runner_work_web_web_node_modules__pnpm_blockstore_core_6_1_2_node_modules_blockstore_core_dist_src_index_js.BaseBlockstore {
+		prefix;
+		base;
+		constructor(options = {}) {
+			super();
+			this.prefix = options.prefix ?? require_constants.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 require_stream.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 = multiformats_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 ?? require_constants.DEFAULT_BLOCKSTORE_PREFIX;
+			this.base = createUnstorageBase(options, getDefaultDriver);
+		}
+		keyToStorageKey(key) {
+			return `${this.prefix}:${key.toString()}`;
+		}
+		storageKeyToKey(storageKey) {
+			return new interface_datastore.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
+exports.createUnstorageBlockstore = createUnstorageBlockstore;
+exports.createUnstorageDatastore = createUnstorageDatastore;
+Object.defineProperty(exports, 'driverFactory', {
+  enumerable: true,
+  get: function () {
+    return driverFactory;
+  }
+});
+exports.setDriverFactory = setDriverFactory;
+//# sourceMappingURL=unstorage-base.cjs.map

package/dist/cjs/blockstore/unstorage-base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unstorage-base.cjs","names":["BaseBlockstore","DEFAULT_BLOCKSTORE_PREFIX","collectAsyncIterable","CID","Key"],"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":";;;;;;;;;AAmCA,IAAW,gBAAsC;AAEjD,SAAgB,iBAAiB,SAAqC;AACpE,iBAAgB;;AAGlB,SAAS,yBACP,SACS;AACT,QAAO,QAAQ,UACX,QAAQ,uCACM,EAAE,QAAQ,QAAQ,QAAQ,CAAC;;AAG/C,eAAe,kBACb,SACA,SACA,kBACe;AACf,KAAI,QAAQ,WAAW,QAAQ,OAC7B;CAGF,MAAM,SAAS,MAAM,iBAAiB,QAAQ,KAAK;AACnD,QAAO,OAAO,sCAAuB,EAAE,QAAQ,CAAC,CAAC;;AAGnD,SAAS,oBACP,SACA,kBACA;CACA,MAAM,UAAU,yBAAyB,QAAQ;CACjD,MAAM,cAAc,kBAAkB,SAAS,SAAS,iBAAiB;CAEzE,eAAe,oBAAmC;AAChD,QAAM;;CAGR,eAAe,QAAQ,KAA+B;AACpD,QAAM,mBAAmB;AACzB,SAAO,MAAM,QAAQ,QAAQ,IAAI;;CAGnC,eAAe,QAAQ,KAAkC;AACvD,QAAM,mBAAmB;EACzB,MAAM,QAAQ,MAAM,QAAQ,WAAuB,IAAI;AAEvD,MAAI,UAAU,KACZ,OAAM,IAAI,MAAM,mBAAmB,MAAM;AAG3C,SAAO;;CAGT,eAAe,QAAQ,KAAa,OAAkC;AACpE,QAAM,mBAAmB;AACzB,QAAM,QAAQ,WAAW,KAAK,MAAM;;CAGtC,eAAe,WAAW,KAA4B;AACpD,QAAM,mBAAmB;AACzB,QAAM,QAAQ,WAAW,IAAI;;CAG/B,eAAe,aAAgC;AAC7C,QAAM,mBAAmB;AACzB,SAAO,MAAM,QAAQ,SAAS;;AAGhC,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACD;;AAGH,SAAgB,0BACd,kBAGuC;AACvC,QAAO,MAAM,4BAA4BA,iIAAe;EACtD,AAAQ;EACR,AAAQ;EAER,YAAY,UAAsC,EAAE,EAAE;AACpD,UAAO;AACP,QAAK,SAAS,QAAQ,UAAUC;AAChC,QAAK,OAAO,oBAAoB,SAAS,iBAAiB;;EAG5D,AAAQ,gBAAgB,KAAkB;AACxC,UAAO,GAAG,KAAK,OAAO,GAAG,IAAI,UAAU;;EAGzC,MAAM,IAAI,KAAU,GAAoC;AACtD,UAAO,MAAM,KAAK,KAAK,QAAQ,KAAK,gBAAgB,IAAI,CAAC;;EAG3D,MAAM,IACJ,KACA,KACA,GACc;GACd,MAAM,aAAa,KAAK,gBAAgB,IAAI;GAC5C,MAAM,QACJ,eAAe,aAAa,MAAM,MAAMC,oCAAqB,IAAI;AACnE,SAAM,KAAK,KAAK,QAAQ,YAAY,MAAM;AAC1C,UAAO;;EAGT,OAAO,QACL,QACA,SACqB;AACrB,cAAW,MAAM,EAAE,KAAK,WAAW,OACjC,OAAM,MAAM,KAAK,IAAI,KAAK,OAAO,QAAQ;;EAI7C,OAAO,IAAI,KAAU,GAA8C;GACjE,MAAM,aAAa,KAAK,gBAAgB,IAAI;AAE5C,SADc,MAAM,KAAK,KAAK,QAAQ,WAAW;;EAInD,OAAO,QACL,QACA,SACgC;AAChC,cAAW,MAAM,OAAO,OACtB,OAAM;IACJ;IACA,OAAQ,mBAAmB;AACzB,YAAO,MAAM,KAAK,IAAI,KAAK,QAAQ;MACnC,KAAK,KAAK;IACb;;EAIL,MAAM,OAAO,KAAU,GAAiC;AACtD,SAAM,KAAK,KAAK,WAAW,KAAK,gBAAgB,IAAI,CAAC;;EAGvD,OAAO,WACL,QACA,SACqB;AACrB,cAAW,MAAM,OAAO,QAAQ;AAC9B,UAAM,KAAK,OAAO,KAAK,QAAQ;AAC/B,UAAM;;;EAIV,OAAO,OAAO,GAAkD;GAC9D,MAAM,OAAO,MAAM,KAAK,KAAK,YAAY;AAEzC,QAAK,MAAM,OAAO,KAChB,KAAI,IAAI,WAAW,KAAK,SAAS,IAAI,EAAE;IACrC,MAAM,YAAY,IAAI,MAAM,KAAK,OAAO,SAAS,EAAE;AACnD,QAAI;KACF,MAAM,MAAMC,qBAAI,MAAM,UAAU;KAChC,MAAM,QAAQ,MAAM,KAAK,KAAK,QAAQ,IAAI;AAE1C,WAAM;MACJ;MACA,QAAQ,mBAAmB;AACzB,aAAM;UACJ;MACL;YACK;;;;;AASlB,SAAgB,yBACd,kBACyD;AACzD,QAAO,MAAM,mBAAwC;EACnD,AAAQ;EACR,AAAQ;EAER,YAAY,UAAsC,EAAE,EAAE;AACpD,QAAK,SACH,QAAQ,mBAAmB,QAAQ,UAAUF;AAC/C,QAAK,OAAO,oBAAoB,SAAS,iBAAiB;;EAG5D,AAAQ,gBAAgB,KAAkB;AACxC,UAAO,GAAG,KAAK,OAAO,GAAG,IAAI,UAAU;;EAGzC,AAAQ,gBAAgB,YAAyB;AAC/C,UAAO,IAAIG,wBAAI,WAAW,MAAM,KAAK,OAAO,SAAS,EAAE,CAAC;;EAG1D,MAAM,IAAI,KAAU,GAAoC;AACtD,UAAO,MAAM,KAAK,KAAK,QAAQ,KAAK,gBAAgB,IAAI,CAAC;;EAG3D,MAAM,IAAI,KAAU,KAAiB,GAAgC;AACnE,SAAM,KAAK,KAAK,QAAQ,KAAK,gBAAgB,IAAI,EAAE,IAAI;AACvD,UAAO;;EAGT,OAAO,QACL,QACA,SACqB;AACrB,cAAW,MAAM,EAAE,KAAK,WAAW,OACjC,OAAM,MAAM,KAAK,IAAI,KAAK,OAAO,QAAQ;;EAI7C,MAAM,IAAI,KAAU,GAAuC;GACzD,MAAM,aAAa,KAAK,gBAAgB,IAAI;AAC5C,OAAI;AACF,WAAO,MAAM,KAAK,KAAK,QAAQ,WAAW;YACnC,OAAO;AACd,UAAM,IAAI,MAAM,6BAA6B,IAAI,UAAU,GAAG;;;EAIlE,OAAO,QACL,QACA,SACsB;AACtB,cAAW,MAAM,OAAO,OACtB,OAAM;IACJ;IACA,OAAO,MAAM,KAAK,IAAI,KAAK,QAAQ;IACpC;;EAIL,MAAM,OAAO,KAAU,GAAiC;AACtD,SAAM,KAAK,KAAK,WAAW,KAAK,gBAAgB,IAAI,CAAC;;EAGvD,OAAO,WACL,QACA,SACqB;AACrB,cAAW,MAAM,OAAO,QAAQ;AAC9B,UAAM,KAAK,OAAO,KAAK,QAAQ;AAC/B,UAAM;;;EAIV,QAAe;GACb,MAAM,aAID,EAAE;GACP,MAAM,OAAO,KAAK;GAClB,MAAM,kBAAkB,KAAK,gBAAgB,KAAK,KAAK;AAEvD,UAAO;IACL,IAAI,KAAU,OAAyB;AACrC,gBAAW,KAAK;MAAE,MAAM;MAAO;MAAK;MAAO,CAAC;;IAE9C,OAAO,KAAgB;AACrB,gBAAW,KAAK;MAAE,MAAM;MAAU;MAAK,CAAC;;IAE1C,MAAM,SAAwB;AAC5B,UAAK,MAAM,MAAM,WACf,KAAI,GAAG,SAAS,SAAS,GAAG,UAAU,OACpC,OAAM,KAAK,QAAQ,gBAAgB,GAAG,IAAI,EAAE,GAAG,MAAM;cAC5C,GAAG,SAAS,SACrB,OAAM,KAAK,WAAW,gBAAgB,GAAG,IAAI,CAAC;AAGlD,gBAAW,SAAS;;IAEvB;;EAGH,OAAO,MAAM,OAAc,GAAwC;GACjE,MAAM,OAAO,MAAM,KAAK,KAAK,YAAY;AAEzC,QAAK,MAAM,OAAO,MAAM;AACtB,QAAI,CAAC,IAAI,WAAW,KAAK,SAAS,IAAI,CACpC;IAGF,MAAM,eAAe,KAAK,gBAAgB,IAAI;AAE9C,QACE,MAAM,UACN,CAAC,aAAa,UAAU,CAAC,WAAW,MAAM,OAAO,UAAU,CAAC,CAE5D;IAGF,MAAM,QAAQ,MAAM,KAAK,KAAK,QAAQ,IAAI;AAE1C,QAAI,MAAM,SAAS;KACjB,IAAI,QAAQ;AACZ,UAAK,MAAM,UAAU,MAAM,QACzB,KAAI,CAAC,OAAO;MAAE,KAAK;MAAc;MAAO,CAAC,EAAE;AACzC,cAAQ;AACR;;AAGJ,SAAI,CAAC,MAAO;;AAGd,UAAM;KACJ,KAAK;KACL;KACD;;;EAIL,OAAO,UAAU,OAAiB,GAAuC;GACvE,MAAM,OAAO,MAAM,KAAK,KAAK,YAAY;AAEzC,QAAK,MAAM,OAAO,MAAM;AACtB,QAAI,CAAC,IAAI,WAAW,KAAK,SAAS,IAAI,CACpC;IAGF,MAAM,eAAe,KAAK,gBAAgB,IAAI;AAE9C,QACE,MAAM,UACN,CAAC,aAAa,UAAU,CAAC,WAAW,MAAM,OAAO,UAAU,CAAC,CAE5D;AAGF,UAAM"}

package/dist/cjs/blockstore/unstorage-base.d.cts

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

package/dist/cjs/blockstore/unstorage.cjs

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

package/dist/cjs/blockstore/unstorage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unstorage.cjs","names":["driverFactory","DEFAULT_BLOCKSTORE_BASE","DEFAULT_BLOCKSTORE_FS_BASE","createUnstorageBlockstore","createUnstorageDatastore"],"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,KAAIA,qCACF,QAAO,MAAMA,sCAAe;AAG9B,KAAI,WAAW,CACb,SAAQ,MAAM,OAAO,+BAA+B,QAAQ,EAC1D,MAAM,QAAQC,2CACf,CAAC;KAEF,SAAQ,MAAM,OAAO,8BAA8B,QAAQ,EACzD,MAAM,QAAQC,8CACf,CAAC;;AAIN,SAAgB,iBAAiB,SAAsC;CACrE,MAAM,kBAAkBC,iDAA0B,iBAAiB;AACnE,QAAO,cAAc,gBAAgB;EACnC,YAAY,iBAA8C;AACxD,SAAM;IAAE,GAAG;IAAS,GAAG;IAAiB,CAAC;;;;AAK/C,SAAgB,gBAAgB,SAAsC;CACpE,MAAM,iBAAiBC,gDAAyB,iBAAiB;AACjE,QAAO,cAAc,eAAe;EAClC,YAAY,iBAA8C;AACxD,SAAM;IAAE,GAAG;IAAS,GAAG;IAAiB,CAAC"}

package/dist/cjs/blockstore/unstorage.d.cts

@@ -0,0 +1,36 @@
+import { UnstorageBlockstoreOptions, setDriverFactory } from "./unstorage-base.cjs";
+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.cts.map

package/dist/cjs/config.d.cts

@@ -0,0 +1,51 @@
+import { Storage } from "unstorage";
+import { Datastore } from "interface-datastore";
+
+//#region src/config.d.ts
+interface PinnerConfig {
+  /**
+   * JWT authentication token. Required for all API operations.
+   */
+  jwt: string;
+  /**
+   * API endpoint URL. Defaults to the official pinning service.
+   * @default "https://ipfs.pinner.xyz"
+   */
+  endpoint?: string;
+  /**
+   * IPFS gateway URL for content retrieval.
+   * @default "https://dweb.link"
+   */
+  gateway?: string;
+  /**
+   * Allowed MIME types for upload. If undefined, all types allowed.
+   */
+  allowedFileTypes?: string[];
+  /**
+   * Custom fetch implementation.
+   */
+  fetch?: typeof fetch;
+  /**
+   * Custom datastore instance for Helia.
+   * If provided, this datastore will be used directly without creating one from storage.
+   * Highest priority - takes precedence over storage and datastoreName.
+   */
+  datastore?: Datastore;
+  /**
+   * Custom storage instance for both Helia blockstore and datastore.
+   * If provided, this storage will be used instead of creating default storage.
+   * The storage instance must implement the unstorage Storage interface.
+   * Used when datastore is not provided.
+   */
+  storage?: Storage;
+  /**
+   * Custom base name for Helia storage.
+   * Passed as the `base` option to both blockstore and datastore storage instances.
+   * Only used when neither datastore nor storage are provided.
+   * @default "pinner-helia-data"
+   */
+  datastoreName?: string;
+}
+//#endregion
+export { PinnerConfig };
+//# sourceMappingURL=config.d.cts.map

package/dist/cjs/encoder/base64.cjs

@@ -0,0 +1,38 @@
+const require_error = require('./error.cjs');
+
+//#region src/encoder/base64.ts
+/**
+* Base64 encoder - converts base64 strings to File objects.
+*/
+var Base64Encoder = class {
+	async encode(base64String, options) {
+		try {
+			const binaryString = atob(base64String);
+			const bytes = new Uint8Array(binaryString.length);
+			for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
+			const blob = new Blob([bytes], { type: "application/octet-stream" });
+			const filename = options?.name || "file.bin";
+			return {
+				file: new File([blob], filename, { type: "application/octet-stream" }),
+				options: {
+					name: options?.name,
+					keyvalues: options?.keyvalues
+				}
+			};
+		} catch (error) {
+			if (error instanceof Error) throw new require_error.EncoderError(`Base64 encoding failed: ${error.message}`, "INVALID_BASE64", error);
+			throw new require_error.EncoderError("Base64 encoding failed: unknown error", "INVALID_BASE64");
+		}
+	}
+};
+/**
+* Encode a base64 string to a File object.
+*/
+async function base64ToFile(base64String, options) {
+	return new Base64Encoder().encode(base64String, options);
+}
+
+//#endregion
+exports.Base64Encoder = Base64Encoder;
+exports.base64ToFile = base64ToFile;
+//# sourceMappingURL=base64.cjs.map

package/dist/cjs/encoder/base64.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.cjs","names":["EncoderError"],"sources":["../../../src/encoder/base64.ts"],"sourcesContent":["import type { Encoder, EncoderResult, UploadOptions } from \"./types\";\nimport { EncoderError } from \"./error\";\n\n/**\n * Base64 encoder - converts base64 strings to File objects.\n */\nexport class Base64Encoder implements Encoder<string> {\n  async encode(\n    base64String: string,\n    options?: UploadOptions,\n  ): Promise<EncoderResult> {\n    try {\n      const binaryString = atob(base64String);\n      const bytes = new Uint8Array(binaryString.length);\n      for (let i = 0; i < binaryString.length; i++) {\n        bytes[i] = binaryString.charCodeAt(i);\n      }\n      const blob = new Blob([bytes], { type: \"application/octet-stream\" });\n      const filename = options?.name || \"file.bin\";\n      const file = new File([blob], filename, {\n        type: \"application/octet-stream\",\n      });\n\n      return {\n        file,\n        options: {\n          name: options?.name,\n          keyvalues: options?.keyvalues,\n        },\n      };\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new EncoderError(\n          `Base64 encoding failed: ${error.message}`,\n          \"INVALID_BASE64\",\n          error,\n        );\n      }\n      throw new EncoderError(\n        \"Base64 encoding failed: unknown error\",\n        \"INVALID_BASE64\",\n      );\n    }\n  }\n}\n\n/**\n * Encode a base64 string to a File object.\n */\nexport async function base64ToFile(\n  base64String: string,\n  options?: UploadOptions,\n): Promise<EncoderResult> {\n  const encoder = new Base64Encoder();\n  return encoder.encode(base64String, options);\n}\n"],"mappings":";;;;;;AAMA,IAAa,gBAAb,MAAsD;CACpD,MAAM,OACJ,cACA,SACwB;AACxB,MAAI;GACF,MAAM,eAAe,KAAK,aAAa;GACvC,MAAM,QAAQ,IAAI,WAAW,aAAa,OAAO;AACjD,QAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,IACvC,OAAM,KAAK,aAAa,WAAW,EAAE;GAEvC,MAAM,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,4BAA4B,CAAC;GACpE,MAAM,WAAW,SAAS,QAAQ;AAKlC,UAAO;IACL,MALW,IAAI,KAAK,CAAC,KAAK,EAAE,UAAU,EACtC,MAAM,4BACP,CAAC;IAIA,SAAS;KACP,MAAM,SAAS;KACf,WAAW,SAAS;KACrB;IACF;WACM,OAAO;AACd,OAAI,iBAAiB,MACnB,OAAM,IAAIA,2BACR,2BAA2B,MAAM,WACjC,kBACA,MACD;AAEH,SAAM,IAAIA,2BACR,yCACA,iBACD;;;;;;;AAQP,eAAsB,aACpB,cACA,SACwB;AAExB,QADgB,IAAI,eAAe,CACpB,OAAO,cAAc,QAAQ"}

package/dist/cjs/encoder/csv/csv-formatter.cjs

@@ -0,0 +1,81 @@
+const require_row_formatter = require('./row-formatter.cjs');
+
+//#region src/encoder/csv/csv-formatter.ts
+/**
+* Simple CSV formatter without streaming support.
+* Converts arrays of objects or arrays to CSV strings.
+*
+* This implementation is derived from @fast-csv/format (https://github.com/C2FO/fast-csv)
+* Copyright (c) 2011 C2FO Labs, LLC
+* Licensed under the MIT License
+*/
+var CsvFormatter = class {
+	options;
+	rowFormatter;
+	hasWrittenBOM = false;
+	constructor(options = {}) {
+		this.options = {
+			objectMode: true,
+			delimiter: ",",
+			rowDelimiter: "\n",
+			quote: "\"",
+			escape: void 0,
+			quoteColumns: false,
+			quoteHeaders: void 0,
+			headers: null,
+			writeHeaders: void 0,
+			includeEndRowDelimiter: false,
+			transform: void 0,
+			writeBOM: false,
+			BOM: "",
+			alwaysWriteHeaders: false,
+			...options
+		};
+		if (typeof this.options.escape !== "string") this.options.escape = this.options.quote === true ? "\"" : this.options.quote;
+		if (typeof this.options.quoteHeaders === "undefined") this.options.quoteHeaders = this.options.quoteColumns;
+		if (this.options.quote === true) this.options.quote = "\"";
+		else if (this.options.quote === false) this.options.quote = "";
+		this.rowFormatter = new require_row_formatter.RowFormatter(this.options);
+		this.hasWrittenBOM = !this.options.writeBOM;
+	}
+	/**
+	* Format an array of rows to CSV string.
+	*/
+	format(rows) {
+		const chunks = [];
+		if (!this.hasWrittenBOM) {
+			chunks.push(this.options.BOM || "");
+			this.hasWrittenBOM = true;
+		}
+		for (const row of rows) {
+			const formattedRows = this.rowFormatter.format(row);
+			chunks.push(...formattedRows);
+		}
+		const finishRows = this.rowFormatter.finish();
+		chunks.push(...finishRows);
+		return chunks.join("");
+	}
+	/**
+	* Format a single row to CSV string.
+	*/
+	formatRow(row) {
+		const chunks = [];
+		if (!this.hasWrittenBOM) {
+			chunks.push(this.options.BOM || "");
+			this.hasWrittenBOM = true;
+		}
+		const formattedRows = this.rowFormatter.format(row);
+		chunks.push(...formattedRows);
+		return chunks.join("");
+	}
+};
+/**
+* Create a CSV formatter with the given options.
+*/
+function createCsvFormatter(options) {
+	return new CsvFormatter(options);
+}
+
+//#endregion
+exports.createCsvFormatter = createCsvFormatter;
+//# sourceMappingURL=csv-formatter.cjs.map

package/dist/cjs/encoder/csv/csv-formatter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-formatter.cjs","names":["RowFormatter"],"sources":["../../../../src/encoder/csv/csv-formatter.ts"],"sourcesContent":["import type { CsvFormatterOptions } from \"./csv-options\";\nimport { RowFormatter } from \"./row-formatter\";\n\nexport type { CsvFormatterOptions };\n\n/**\n * Simple CSV formatter without streaming support.\n * Converts arrays of objects or arrays to CSV strings.\n *\n * This implementation is derived from @fast-csv/format (https://github.com/C2FO/fast-csv)\n * Copyright (c) 2011 C2FO Labs, LLC\n * Licensed under the MIT License\n */\nexport class CsvFormatter {\n  private options: CsvFormatterOptions;\n  private rowFormatter: RowFormatter;\n  private hasWrittenBOM = false;\n\n  constructor(options: CsvFormatterOptions = {}) {\n    this.options = {\n      objectMode: true,\n      delimiter: \",\",\n      rowDelimiter: \"\\n\",\n      quote: '\"',\n      escape: undefined,\n      quoteColumns: false,\n      quoteHeaders: undefined,\n      headers: null as string[] | null,\n      writeHeaders: undefined,\n      includeEndRowDelimiter: false,\n      transform: undefined,\n      writeBOM: false,\n      BOM: \"\\ufeff\",\n      alwaysWriteHeaders: false,\n      ...options,\n    };\n\n    // Set escape to quote if not provided\n    if (typeof this.options.escape !== \"string\") {\n      this.options.escape =\n        this.options.quote === true ? '\"' : (this.options.quote as string);\n    }\n\n    // Set quoteHeaders to quoteColumns if not provided\n    if (typeof this.options.quoteHeaders === \"undefined\") {\n      this.options.quoteHeaders = this.options.quoteColumns;\n    }\n\n    // Normalize quote option\n    if (this.options.quote === true) {\n      this.options.quote = '\"';\n    } else if (this.options.quote === false) {\n      this.options.quote = \"\";\n    }\n\n    this.rowFormatter = new RowFormatter(this.options);\n    this.hasWrittenBOM = !this.options.writeBOM;\n  }\n\n  /**\n   * Format an array of rows to CSV string.\n   */\n  format(rows: unknown[]): string {\n    const chunks: string[] = [];\n\n    // Write BOM if configured\n    if (!this.hasWrittenBOM) {\n      chunks.push(this.options.BOM || \"\\ufeff\");\n      this.hasWrittenBOM = true;\n    }\n\n    // Format each row\n    for (const row of rows) {\n      const formattedRows = this.rowFormatter.format(row);\n      chunks.push(...formattedRows);\n    }\n\n    // Add finish content (end row delimiter, etc.)\n    const finishRows = this.rowFormatter.finish();\n    chunks.push(...finishRows);\n\n    return chunks.join(\"\");\n  }\n\n  /**\n   * Format a single row to CSV string.\n   */\n  formatRow(row: unknown): string {\n    const chunks: string[] = [];\n\n    // Write BOM if configured\n    if (!this.hasWrittenBOM) {\n      chunks.push(this.options.BOM || \"\\ufeff\");\n      this.hasWrittenBOM = true;\n    }\n\n    const formattedRows = this.rowFormatter.format(row);\n    chunks.push(...formattedRows);\n\n    return chunks.join(\"\");\n  }\n}\n\n/**\n * Create a CSV formatter with the given options.\n */\nexport function createCsvFormatter(\n  options?: CsvFormatterOptions,\n): CsvFormatter {\n  return new CsvFormatter(options);\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAa,eAAb,MAA0B;CACxB,AAAQ;CACR,AAAQ;CACR,AAAQ,gBAAgB;CAExB,YAAY,UAA+B,EAAE,EAAE;AAC7C,OAAK,UAAU;GACb,YAAY;GACZ,WAAW;GACX,cAAc;GACd,OAAO;GACP,QAAQ;GACR,cAAc;GACd,cAAc;GACd,SAAS;GACT,cAAc;GACd,wBAAwB;GACxB,WAAW;GACX,UAAU;GACV,KAAK;GACL,oBAAoB;GACpB,GAAG;GACJ;AAGD,MAAI,OAAO,KAAK,QAAQ,WAAW,SACjC,MAAK,QAAQ,SACX,KAAK,QAAQ,UAAU,OAAO,OAAO,KAAK,QAAQ;AAItD,MAAI,OAAO,KAAK,QAAQ,iBAAiB,YACvC,MAAK,QAAQ,eAAe,KAAK,QAAQ;AAI3C,MAAI,KAAK,QAAQ,UAAU,KACzB,MAAK,QAAQ,QAAQ;WACZ,KAAK,QAAQ,UAAU,MAChC,MAAK,QAAQ,QAAQ;AAGvB,OAAK,eAAe,IAAIA,mCAAa,KAAK,QAAQ;AAClD,OAAK,gBAAgB,CAAC,KAAK,QAAQ;;;;;CAMrC,OAAO,MAAyB;EAC9B,MAAM,SAAmB,EAAE;AAG3B,MAAI,CAAC,KAAK,eAAe;AACvB,UAAO,KAAK,KAAK,QAAQ,OAAO,IAAS;AACzC,QAAK,gBAAgB;;AAIvB,OAAK,MAAM,OAAO,MAAM;GACtB,MAAM,gBAAgB,KAAK,aAAa,OAAO,IAAI;AACnD,UAAO,KAAK,GAAG,cAAc;;EAI/B,MAAM,aAAa,KAAK,aAAa,QAAQ;AAC7C,SAAO,KAAK,GAAG,WAAW;AAE1B,SAAO,OAAO,KAAK,GAAG;;;;;CAMxB,UAAU,KAAsB;EAC9B,MAAM,SAAmB,EAAE;AAG3B,MAAI,CAAC,KAAK,eAAe;AACvB,UAAO,KAAK,KAAK,QAAQ,OAAO,IAAS;AACzC,QAAK,gBAAgB;;EAGvB,MAAM,gBAAgB,KAAK,aAAa,OAAO,IAAI;AACnD,SAAO,KAAK,GAAG,cAAc;AAE7B,SAAO,OAAO,KAAK,GAAG;;;;;;AAO1B,SAAgB,mBACd,SACc;AACd,QAAO,IAAI,aAAa,QAAQ"}

package/dist/cjs/encoder/csv/field-formatter.cjs

@@ -0,0 +1,76 @@
+
+//#region src/encoder/csv/field-formatter.ts
+/**
+* Escape special regex characters in a string.
+*/
+function escapeRegExp(str) {
+	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+* Handles formatting of individual CSV fields including quoting and escaping.
+*
+* This implementation is derived from @fast-csv/format (https://github.com/C2FO/fast-csv)
+* Copyright (c) 2011 C2FO Labs, LLC
+* Licensed under the MIT License
+*/
+var FieldFormatter = class {
+	options;
+	_headers = null;
+	quoteReplaceRegExp;
+	escapePatternRegExp;
+	constructor(options) {
+		this.options = options;
+		if (Array.isArray(options.headers)) this._headers = options.headers;
+		else this._headers = null;
+		const quote = options.quote === true ? "\"" : options.quote === false ? "" : options.quote ?? "\"";
+		this.quoteReplaceRegExp = new RegExp(quote, "g");
+		const escapePattern = `[${escapeRegExp(options.delimiter ?? ",")}${escapeRegExp(options.rowDelimiter ?? "\n")}|\r|\n]`;
+		this.escapePatternRegExp = new RegExp(escapePattern);
+	}
+	get headers() {
+		return this._headers;
+	}
+	set headers(headers) {
+		this._headers = headers;
+	}
+	/**
+	* Escape special regex characters in a string.
+	*/
+	#escapeRegExpString(str) {
+		return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	}
+	/**
+	* Determine if a field should be quoted.
+	*/
+	shouldQuote(fieldIndex, isHeader) {
+		const quoteConfig = isHeader ? this.options.quoteHeaders : this.options.quoteColumns;
+		if (typeof quoteConfig === "boolean") return quoteConfig;
+		if (Array.isArray(quoteConfig)) return quoteConfig[fieldIndex] === true;
+		if (this._headers !== null && typeof quoteConfig === "object") return quoteConfig[this._headers[fieldIndex]] === true;
+		return false;
+	}
+	/**
+	* Format a single field value.
+	*/
+	format(field, fieldIndex, isHeader) {
+		const quote = this.options.quote === true ? "\"" : this.options.quote === false ? "" : this.options.quote ?? "\"";
+		const escape = this.options.escape ?? quote;
+		const preparedField = `${field == null ? "" : field}`.replace(/\0/g, "");
+		if (quote !== "") {
+			if (preparedField.indexOf(quote) !== -1) return this.quoteField(preparedField.replace(this.quoteReplaceRegExp, `${escape}${quote}`));
+		}
+		if (preparedField.search(this.escapePatternRegExp) !== -1 || this.shouldQuote(fieldIndex, isHeader)) return this.quoteField(preparedField);
+		return preparedField;
+	}
+	/**
+	* Quote a field value.
+	*/
+	quoteField(field) {
+		const quote = this.options.quote === true ? "\"" : this.options.quote === false ? "" : this.options.quote ?? "\"";
+		return `${quote}${field}${quote}`;
+	}
+};
+
+//#endregion
+exports.FieldFormatter = FieldFormatter;
+//# sourceMappingURL=field-formatter.cjs.map

package/dist/cjs/encoder/csv/field-formatter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-formatter.cjs","names":[],"sources":["../../../../src/encoder/csv/field-formatter.ts"],"sourcesContent":["import type { CsvFormatterOptions } from \"./csv-options\";\n\n/**\n * Escape special regex characters in a string.\n */\nfunction escapeRegExp(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\n/**\n * Handles formatting of individual CSV fields including quoting and escaping.\n *\n * This implementation is derived from @fast-csv/format (https://github.com/C2FO/fast-csv)\n * Copyright (c) 2011 C2FO Labs, LLC\n * Licensed under the MIT License\n */\nexport class FieldFormatter {\n  private options: CsvFormatterOptions;\n  private _headers: string[] | null = null;\n  private quoteReplaceRegExp: RegExp;\n  private escapePatternRegExp: RegExp;\n\n  constructor(options: CsvFormatterOptions) {\n    this.options = options;\n\n    if (Array.isArray(options.headers)) {\n      this._headers = options.headers;\n    } else {\n      this._headers = null;\n    }\n\n    const quote =\n      options.quote === true\n        ? '\"'\n        : options.quote === false\n          ? \"\"\n          : (options.quote ?? '\"');\n    this.quoteReplaceRegExp = new RegExp(quote, \"g\");\n\n    // Use lodash.escapeRegExp pattern for delimiter and row delimiter\n    const escapePattern = `[${escapeRegExp(options.delimiter ?? \",\")}${escapeRegExp(options.rowDelimiter ?? \"\\n\")}|\\r|\\n]`;\n    this.escapePatternRegExp = new RegExp(escapePattern);\n  }\n\n  get headers(): string[] | null {\n    return this._headers;\n  }\n\n  set headers(headers: string[] | null) {\n    this._headers = headers;\n  }\n\n  /**\n   * Escape special regex characters in a string.\n   */\n  #escapeRegExpString(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n\n  /**\n   * Determine if a field should be quoted.\n   */\n  private shouldQuote(fieldIndex: number, isHeader: boolean): boolean {\n    const quoteConfig = isHeader\n      ? this.options.quoteHeaders\n      : this.options.quoteColumns;\n\n    if (typeof quoteConfig === \"boolean\") {\n      return quoteConfig;\n    }\n\n    if (Array.isArray(quoteConfig)) {\n      return quoteConfig[fieldIndex] === true;\n    }\n\n    if (this._headers !== null && typeof quoteConfig === \"object\") {\n      return quoteConfig[this._headers[fieldIndex]] === true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Format a single field value.\n   */\n  format(field: unknown, fieldIndex: number, isHeader: boolean): string {\n    const quote =\n      this.options.quote === true\n        ? '\"'\n        : this.options.quote === false\n          ? \"\"\n          : (this.options.quote ?? '\"');\n    const escape = this.options.escape ?? quote;\n\n    // Convert to string, handle null/undefined\n    const preparedField = `${field == null ? \"\" : field}`.replace(/\\0/g, \"\");\n\n    // Handle quote escaping\n    if (quote !== \"\") {\n      const shouldEscape = preparedField.indexOf(quote) !== -1;\n      if (shouldEscape) {\n        return this.quoteField(\n          preparedField.replace(this.quoteReplaceRegExp, `${escape}${quote}`),\n        );\n      }\n    }\n\n    // Check if field needs quoting (contains delimiter, row delimiter, etc.)\n    const hasEscapeCharacters =\n      preparedField.search(this.escapePatternRegExp) !== -1;\n    if (hasEscapeCharacters || this.shouldQuote(fieldIndex, isHeader)) {\n      return this.quoteField(preparedField);\n    }\n\n    return preparedField;\n  }\n\n  /**\n   * Quote a field value.\n   */\n  private quoteField(field: string): string {\n    const quote =\n      this.options.quote === true\n        ? '\"'\n        : this.options.quote === false\n          ? \"\"\n          : (this.options.quote ?? '\"');\n    return `${quote}${field}${quote}`;\n  }\n}\n"],"mappings":";;;;;AAKA,SAAS,aAAa,KAAqB;AACzC,QAAO,IAAI,QAAQ,uBAAuB,OAAO;;;;;;;;;AAUnD,IAAa,iBAAb,MAA4B;CAC1B,AAAQ;CACR,AAAQ,WAA4B;CACpC,AAAQ;CACR,AAAQ;CAER,YAAY,SAA8B;AACxC,OAAK,UAAU;AAEf,MAAI,MAAM,QAAQ,QAAQ,QAAQ,CAChC,MAAK,WAAW,QAAQ;MAExB,MAAK,WAAW;EAGlB,MAAM,QACJ,QAAQ,UAAU,OACd,OACA,QAAQ,UAAU,QAChB,KACC,QAAQ,SAAS;AAC1B,OAAK,qBAAqB,IAAI,OAAO,OAAO,IAAI;EAGhD,MAAM,gBAAgB,IAAI,aAAa,QAAQ,aAAa,IAAI,GAAG,aAAa,QAAQ,gBAAgB,KAAK,CAAC;AAC9G,OAAK,sBAAsB,IAAI,OAAO,cAAc;;CAGtD,IAAI,UAA2B;AAC7B,SAAO,KAAK;;CAGd,IAAI,QAAQ,SAA0B;AACpC,OAAK,WAAW;;;;;CAMlB,oBAAoB,KAAqB;AACvC,SAAO,IAAI,QAAQ,uBAAuB,OAAO;;;;;CAMnD,AAAQ,YAAY,YAAoB,UAA4B;EAClE,MAAM,cAAc,WAChB,KAAK,QAAQ,eACb,KAAK,QAAQ;AAEjB,MAAI,OAAO,gBAAgB,UACzB,QAAO;AAGT,MAAI,MAAM,QAAQ,YAAY,CAC5B,QAAO,YAAY,gBAAgB;AAGrC,MAAI,KAAK,aAAa,QAAQ,OAAO,gBAAgB,SACnD,QAAO,YAAY,KAAK,SAAS,iBAAiB;AAGpD,SAAO;;;;;CAMT,OAAO,OAAgB,YAAoB,UAA2B;EACpE,MAAM,QACJ,KAAK,QAAQ,UAAU,OACnB,OACA,KAAK,QAAQ,UAAU,QACrB,KACC,KAAK,QAAQ,SAAS;EAC/B,MAAM,SAAS,KAAK,QAAQ,UAAU;EAGtC,MAAM,gBAAgB,GAAG,SAAS,OAAO,KAAK,QAAQ,QAAQ,OAAO,GAAG;AAGxE,MAAI,UAAU,IAEZ;OADqB,cAAc,QAAQ,MAAM,KAAK,GAEpD,QAAO,KAAK,WACV,cAAc,QAAQ,KAAK,oBAAoB,GAAG,SAAS,QAAQ,CACpE;;AAOL,MADE,cAAc,OAAO,KAAK,oBAAoB,KAAK,MAC1B,KAAK,YAAY,YAAY,SAAS,CAC/D,QAAO,KAAK,WAAW,cAAc;AAGvC,SAAO;;;;;CAMT,AAAQ,WAAW,OAAuB;EACxC,MAAM,QACJ,KAAK,QAAQ,UAAU,OACnB,OACA,KAAK,QAAQ,UAAU,QACrB,KACC,KAAK,QAAQ,SAAS;AAC/B,SAAO,GAAG,QAAQ,QAAQ"}