@lumeweb/pinner 0.0.1 → 0.1.1

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"}

package/dist/esm/config.d.ts

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

package/dist/esm/encoder/base64.js

@@ -0,0 +1,37 @@
+import { EncoderError } from "./error.js";
+
+//#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 EncoderError(`Base64 encoding failed: ${error.message}`, "INVALID_BASE64", error);
+			throw new 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
+export { Base64Encoder, base64ToFile };
+//# sourceMappingURL=base64.js.map

package/dist/esm/encoder/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","names":[],"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,IAAI,aACR,2BAA2B,MAAM,WACjC,kBACA,MACD;AAEH,SAAM,IAAI,aACR,yCACA,iBACD;;;;;;;AAQP,eAAsB,aACpB,cACA,SACwB;AAExB,QADgB,IAAI,eAAe,CACpB,OAAO,cAAc,QAAQ"}

package/dist/esm/encoder/csv/csv-formatter.js

@@ -0,0 +1,81 @@
+import { RowFormatter } from "./row-formatter.js";
+
+//#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 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
+export { createCsvFormatter };
+//# sourceMappingURL=csv-formatter.js.map

package/dist/esm/encoder/csv/csv-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-formatter.js","names":[],"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,IAAI,aAAa,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/esm/encoder/csv/field-formatter.js

@@ -0,0 +1,75 @@
+//#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
+export { FieldFormatter };
+//# sourceMappingURL=field-formatter.js.map

package/dist/esm/encoder/csv/field-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-formatter.js","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"}

package/dist/esm/encoder/csv/row-formatter.js

@@ -0,0 +1,159 @@
+import { FieldFormatter } from "./field-formatter.js";
+
+//#region src/encoder/csv/row-formatter.ts
+/**
+* Handles formatting of CSV rows including headers and column extraction.
+*
+* 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 RowFormatter = class {
+	options;
+	fieldFormatter;
+	shouldWriteHeaders;
+	rowTransform = null;
+	headers = null;
+	hasWrittenHeaders = false;
+	rowCount = 0;
+	constructor(options) {
+		this.options = options;
+		this.fieldFormatter = new FieldFormatter(options);
+		this.headers = Array.isArray(options.headers) ? options.headers : null;
+		this.shouldWriteHeaders = options.writeHeaders ?? (Array.isArray(options.headers) || options.headers === true);
+		if (this.headers !== null) this.fieldFormatter.headers = this.headers;
+		if (options.transform) this.rowTransform = this.createTransform(options.transform);
+	}
+	/**
+	* Create a transform function that handles both sync and async transforms.
+	*/
+	createTransform(transformFn) {
+		if (transformFn.length === 1) return (row, cb) => {
+			try {
+				cb(null, transformFn(row));
+			} catch (e) {
+				cb(e instanceof Error ? e : new Error(String(e)));
+			}
+		};
+		return transformFn;
+	}
+	/**
+	* Check if the transform is synchronous (arity 1).
+	*/
+	isSyncTransform() {
+		if (!this.options.transform) return true;
+		return this.options.transform.length === 1;
+	}
+	/**
+	* Format a single row.
+	*/
+	format(row) {
+		let transformedRow;
+		if (this.rowTransform) transformedRow = this.applyTransformSync(row);
+		else transformedRow = row;
+		if (!transformedRow) return [];
+		const rows = [];
+		const { shouldFormatColumns, headers } = this.checkHeaders(transformedRow);
+		if (this.shouldWriteHeaders && headers && !this.hasWrittenHeaders) {
+			rows.push(this.formatColumns(headers, true));
+			this.hasWrittenHeaders = true;
+		}
+		if (shouldFormatColumns) {
+			const columns = this.gatherColumns(transformedRow);
+			rows.push(this.formatColumns(columns, false));
+		}
+		return rows;
+	}
+	/**
+	* Apply transform synchronously.
+	* Note: This only supports sync transforms. Async transforms are not supported
+	* in the synchronous format() method.
+	*/
+	applyTransformSync(row) {
+		if (!this.options.transform) return row;
+		if (this.isSyncTransform()) try {
+			return this.options.transform(row);
+		} catch (e) {
+			throw e instanceof Error ? e : new Error(String(e));
+		}
+		throw new Error("Async transforms are not supported in synchronous CSV formatting");
+	}
+	/**
+	* Finish formatting and return any trailing content.
+	*/
+	finish() {
+		const rows = [];
+		if (this.options.alwaysWriteHeaders && this.rowCount === 0) {
+			if (!this.headers) throw new Error("`alwaysWriteHeaders` option is set to true but `headers` option not provided.");
+			rows.push(this.formatColumns(this.headers, true));
+		}
+		if (this.options.includeEndRowDelimiter) rows.push(this.options.rowDelimiter || "\n");
+		return rows;
+	}
+	/**
+	* Check if headers need to be written.
+	*/
+	checkHeaders(row) {
+		if (this.headers) return {
+			shouldFormatColumns: true,
+			headers: this.headers
+		};
+		const headers = this.gatherHeaders(row);
+		this.headers = headers;
+		this.fieldFormatter.headers = headers;
+		if (!this.shouldWriteHeaders) return {
+			shouldFormatColumns: true,
+			headers: null
+		};
+		if (Array.isArray(row) && headers.every((header, i) => header === row[i])) return {
+			shouldFormatColumns: false,
+			headers
+		};
+		return {
+			shouldFormatColumns: true,
+			headers
+		};
+	}
+	/**
+	* Extract headers from a row.
+	*/
+	gatherHeaders(row) {
+		if (this.isRowHashArray(row)) return row.map((it) => String(it[0]));
+		if (Array.isArray(row)) return row.map(String);
+		return Object.keys(row);
+	}
+	/**
+	* Check if row is a hash array (multi-dimensional array with [key, value] pairs).
+	*/
+	isRowHashArray(row) {
+		if (!Array.isArray(row)) return false;
+		return Array.isArray(row[0]) && row[0].length === 2;
+	}
+	/**
+	* Extract column values from a row.
+	*/
+	gatherColumns(row) {
+		if (this.headers === null) throw new Error("Headers is currently null");
+		if (!Array.isArray(row)) return this.headers.map((header) => row[header]);
+		if (this.isRowHashArray(row)) return this.headers.map((header, i) => {
+			const col = row[i];
+			return col ? col[1] : "";
+		});
+		if (!this.shouldWriteHeaders) return row;
+		return this.headers.map((_, i) => row[i]);
+	}
+	/**
+	* Format columns into a CSV row string.
+	*/
+	formatColumns(columns, isHeadersRow) {
+		const formattedCols = columns.map((field, i) => this.fieldFormatter.format(field, i, isHeadersRow)).join(this.options.delimiter || ",");
+		const { rowCount } = this;
+		this.rowCount += 1;
+		if (rowCount > 0) return [this.options.rowDelimiter || "\n", formattedCols].join("");
+		return formattedCols;
+	}
+};
+
+//#endregion
+export { RowFormatter };
+//# sourceMappingURL=row-formatter.js.map

package/dist/esm/encoder/csv/row-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-formatter.js","names":[],"sources":["../../../../src/encoder/csv/row-formatter.ts"],"sourcesContent":["import type {\n  CsvFormatterOptions,\n  RowTransform,\n  RowTransformCallback,\n} from \"./csv-options\";\nimport { FieldFormatter } from \"./field-formatter\";\n\n/**\n * Handles formatting of CSV rows including headers and column extraction.\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 RowFormatter {\n  private options: CsvFormatterOptions;\n  private fieldFormatter: FieldFormatter;\n  private shouldWriteHeaders: boolean;\n  private rowTransform: RowTransformCallback | null = null;\n  private headers: string[] | null = null;\n  private hasWrittenHeaders = false;\n  private rowCount = 0;\n\n  constructor(options: CsvFormatterOptions) {\n    this.options = options;\n    this.fieldFormatter = new FieldFormatter(options);\n    this.headers = Array.isArray(options.headers) ? options.headers : null;\n    this.shouldWriteHeaders =\n      options.writeHeaders ??\n      (Array.isArray(options.headers) || options.headers === true);\n\n    if (this.headers !== null) {\n      this.fieldFormatter.headers = this.headers;\n    }\n\n    if (options.transform) {\n      this.rowTransform = this.createTransform(options.transform);\n    }\n  }\n\n  /**\n   * Create a transform function that handles both sync and async transforms.\n   */\n  private createTransform(transformFn: RowTransform): RowTransformCallback {\n    // Check if it's a sync transform (arity 1)\n    if (transformFn.length === 1) {\n      return (row: unknown, cb: RowTransformCallback) => {\n        try {\n          const transformedRow = (transformFn as (row: unknown) => unknown)(\n            row,\n          );\n          cb(null, transformedRow);\n        } catch (e) {\n          cb(e instanceof Error ? e : new Error(String(e)));\n        }\n      };\n    }\n\n    return transformFn as RowTransformCallback;\n  }\n\n  /**\n   * Check if the transform is synchronous (arity 1).\n   */\n  private isSyncTransform(): boolean {\n    if (!this.options.transform) {\n      return true;\n    }\n    return this.options.transform.length === 1;\n  }\n\n  /**\n   * Format a single row.\n   */\n  format(row: unknown): string[] {\n    let transformedRow: unknown;\n\n    // Apply transform if present\n    if (this.rowTransform) {\n      transformedRow = this.applyTransformSync(row);\n    } else {\n      transformedRow = row;\n    }\n\n    if (!transformedRow) {\n      return [];\n    }\n\n    const rows: string[] = [];\n\n    // Check headers\n    const { shouldFormatColumns, headers } = this.checkHeaders(transformedRow);\n\n    // Write headers if needed\n    if (this.shouldWriteHeaders && headers && !this.hasWrittenHeaders) {\n      rows.push(this.formatColumns(headers, true));\n      this.hasWrittenHeaders = true;\n    }\n\n    // Format data row\n    if (shouldFormatColumns) {\n      const columns = this.gatherColumns(transformedRow);\n      rows.push(this.formatColumns(columns, false));\n    }\n\n    return rows;\n  }\n\n  /**\n   * Apply transform synchronously.\n   * Note: This only supports sync transforms. Async transforms are not supported\n   * in the synchronous format() method.\n   */\n  private applyTransformSync(row: unknown): unknown {\n    if (!this.options.transform) {\n      return row;\n    }\n\n    // Only sync transforms (arity 1) are supported\n    if (this.isSyncTransform()) {\n      try {\n        return (this.options.transform as (row: unknown) => unknown)(row);\n      } catch (e) {\n        throw e instanceof Error ? e : new Error(String(e));\n      }\n    }\n\n    throw new Error(\n      \"Async transforms are not supported in synchronous CSV formatting\",\n    );\n  }\n\n  /**\n   * Finish formatting and return any trailing content.\n   */\n  finish(): string[] {\n    const rows: string[] = [];\n\n    // Write headers if alwaysWriteHeaders is true and no rows were written\n    if (this.options.alwaysWriteHeaders && this.rowCount === 0) {\n      if (!this.headers) {\n        throw new Error(\n          \"`alwaysWriteHeaders` option is set to true but `headers` option not provided.\",\n        );\n      }\n      rows.push(this.formatColumns(this.headers, true));\n    }\n\n    // Add end row delimiter if configured\n    if (this.options.includeEndRowDelimiter) {\n      rows.push(this.options.rowDelimiter || \"\\n\");\n    }\n\n    return rows;\n  }\n\n  /**\n   * Check if headers need to be written.\n   */\n  private checkHeaders(row: unknown): {\n    shouldFormatColumns: boolean;\n    headers: string[] | null;\n  } {\n    if (this.headers) {\n      return { shouldFormatColumns: true, headers: this.headers };\n    }\n\n    const headers = this.gatherHeaders(row);\n    this.headers = headers;\n    this.fieldFormatter.headers = headers;\n\n    if (!this.shouldWriteHeaders) {\n      return { shouldFormatColumns: true, headers: null };\n    }\n\n    // If the row is equal to headers, don't format (it's the header row itself)\n    if (Array.isArray(row) && headers.every((header, i) => header === row[i])) {\n      return { shouldFormatColumns: false, headers };\n    }\n\n    return { shouldFormatColumns: true, headers };\n  }\n\n  /**\n   * Extract headers from a row.\n   */\n  private gatherHeaders(row: unknown): string[] {\n    if (this.isRowHashArray(row)) {\n      // Multi-dimensional array with item 0 being the header\n      return (row as unknown[][]).map((it) => String(it[0]));\n    }\n\n    if (Array.isArray(row)) {\n      return row.map(String);\n    }\n\n    return Object.keys(row as object);\n  }\n\n  /**\n   * Check if row is a hash array (multi-dimensional array with [key, value] pairs).\n   */\n  private isRowHashArray(row: unknown): boolean {\n    if (!Array.isArray(row)) {\n      return false;\n    }\n    return Array.isArray(row[0]) && row[0].length === 2;\n  }\n\n  /**\n   * Extract column values from a row.\n   */\n  private gatherColumns(row: unknown): unknown[] {\n    if (this.headers === null) {\n      throw new Error(\"Headers is currently null\");\n    }\n\n    if (!Array.isArray(row)) {\n      // Object: use headers to get values\n      return this.headers.map(\n        (header) => (row as Record<string, unknown>)[header],\n      );\n    }\n\n    if (this.isRowHashArray(row)) {\n      // Hash array: extract values\n      return this.headers.map((header, i) => {\n        const col = (row as unknown[][])[i];\n        return col ? col[1] : \"\";\n      });\n    }\n\n    // Regular array\n    if (!this.shouldWriteHeaders) {\n      // If headers weren't written, return the row as-is\n      return row;\n    }\n\n    // Map by header index\n    return this.headers.map((_, i) => row[i]);\n  }\n\n  /**\n   * Format columns into a CSV row string.\n   */\n  private formatColumns(columns: unknown[], isHeadersRow: boolean): string {\n    const formattedCols = columns\n      .map((field, i) => this.fieldFormatter.format(field, i, isHeadersRow))\n      .join(this.options.delimiter || \",\");\n\n    const { rowCount } = this;\n    this.rowCount += 1;\n\n    // Add row delimiter before all rows except the first\n    if (rowCount > 0) {\n      return [this.options.rowDelimiter || \"\\n\", formattedCols].join(\"\");\n    }\n\n    return formattedCols;\n  }\n}\n"],"mappings":"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"}

package/dist/esm/encoder/csv.js

@@ -0,0 +1,43 @@
+import { EncoderError } from "./error.js";
+import { createCsvFormatter } from "./csv/csv-formatter.js";
+
+//#region src/encoder/csv.ts
+/**
+* CSV encoder - converts CSV strings, arrays of objects, or arrays of arrays to File objects.
+* Uses a simplified CSV formatter without streaming support.
+*/
+var CsvEncoder = class {
+	async encode(input, options) {
+		try {
+			let csvContent;
+			if (typeof input === "string") csvContent = input;
+			else if (Array.isArray(input)) csvContent = this.#arrayToCsv(input, options?.csv);
+			else throw new EncoderError("Invalid CSV input: must be string or array", "INVALID_CSV");
+			const blob = new Blob([csvContent], { type: "text/csv" });
+			return {
+				file: new File([blob], options?.name || "data.csv", { type: "text/csv" }),
+				options: options || {}
+			};
+		} catch (error) {
+			if (error instanceof EncoderError) throw error;
+			if (error instanceof Error) throw new EncoderError(`CSV encoding failed: ${error.message}`, "INVALID_CSV", error);
+			throw new EncoderError("CSV encoding failed: unknown error", "INVALID_CSV");
+		}
+	}
+	#arrayToCsv(data, csvOptions) {
+		return createCsvFormatter({
+			headers: true,
+			...csvOptions
+		}).format(data);
+	}
+};
+/**
+* Encode CSV data to a File object.
+*/
+async function csvToFile(data, options) {
+	return new CsvEncoder().encode(data, options);
+}
+
+//#endregion
+export { CsvEncoder, csvToFile };
+//# sourceMappingURL=csv.js.map

package/dist/esm/encoder/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","names":["#arrayToCsv"],"sources":["../../../src/encoder/csv.ts"],"sourcesContent":["import type { Encoder, EncoderResult, UploadOptions } from \"./types\";\nimport { EncoderError } from \"./error\";\nimport {\n  createCsvFormatter,\n  type CsvFormatterOptions,\n} from \"./csv/csv-formatter\";\n\n/**\n * CSV encoder - converts CSV strings, arrays of objects, or arrays of arrays to File objects.\n * Uses a simplified CSV formatter without streaming support.\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 */\n\n/**\n * Extended upload options for CSV encoder.\n * Extends base UploadOptions with CSV formatting options.\n */\nexport interface CsvUploadOptions extends UploadOptions {\n  /**\n   * CSV formatting options.\n   */\n  csv?: CsvFormatterOptions;\n}\n\n/**\n * CSV encoder - converts CSV strings, arrays of objects, or arrays of arrays to File objects.\n * Uses a simplified CSV formatter without streaming support.\n */\nexport class CsvEncoder implements Encoder<string | object[] | any[][]> {\n  async encode(\n    input: string | object[] | any[][],\n    options?: CsvUploadOptions,\n  ): Promise<EncoderResult> {\n    try {\n      let csvContent: string;\n\n      if (typeof input === \"string\") {\n        // Raw CSV string - use as-is\n        csvContent = input;\n      } else if (Array.isArray(input)) {\n        // Convert array to CSV using our formatter\n        csvContent = this.#arrayToCsv(input, options?.csv);\n      } else {\n        throw new EncoderError(\n          \"Invalid CSV input: must be string or array\",\n          \"INVALID_CSV\",\n        );\n      }\n\n      const blob = new Blob([csvContent], { type: \"text/csv\" });\n      const file = new File([blob], options?.name || \"data.csv\", {\n        type: \"text/csv\",\n      });\n\n      return {\n        file,\n        options: options || {},\n      };\n    } catch (error) {\n      if (error instanceof EncoderError) {\n        throw error;\n      }\n      if (error instanceof Error) {\n        throw new EncoderError(\n          `CSV encoding failed: ${error.message}`,\n          \"INVALID_CSV\",\n          error,\n        );\n      }\n      throw new EncoderError(\n        \"CSV encoding failed: unknown error\",\n        \"INVALID_CSV\",\n      );\n    }\n  }\n\n  #arrayToCsv(\n    data: any[] | object[][],\n    csvOptions?: CsvFormatterOptions,\n  ): string {\n    const formatter = createCsvFormatter({\n      headers: true,\n      ...csvOptions,\n    });\n\n    return formatter.format(data);\n  }\n}\n\n/**\n * Encode CSV data to a File object.\n */\nexport async function csvToFile(\n  data: string | object[] | any[][],\n  options?: CsvUploadOptions,\n): Promise<EncoderResult> {\n  const encoder = new CsvEncoder();\n  return encoder.encode(data, options);\n}\n"],"mappings":";;;;;;;;AA+BA,IAAa,aAAb,MAAwE;CACtE,MAAM,OACJ,OACA,SACwB;AACxB,MAAI;GACF,IAAI;AAEJ,OAAI,OAAO,UAAU,SAEnB,cAAa;YACJ,MAAM,QAAQ,MAAM,CAE7B,cAAa,MAAKA,WAAY,OAAO,SAAS,IAAI;OAElD,OAAM,IAAI,aACR,8CACA,cACD;GAGH,MAAM,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,MAAM,YAAY,CAAC;AAKzD,UAAO;IACL,MALW,IAAI,KAAK,CAAC,KAAK,EAAE,SAAS,QAAQ,YAAY,EACzD,MAAM,YACP,CAAC;IAIA,SAAS,WAAW,EAAE;IACvB;WACM,OAAO;AACd,OAAI,iBAAiB,aACnB,OAAM;AAER,OAAI,iBAAiB,MACnB,OAAM,IAAI,aACR,wBAAwB,MAAM,WAC9B,eACA,MACD;AAEH,SAAM,IAAI,aACR,sCACA,cACD;;;CAIL,YACE,MACA,YACQ;AAMR,SALkB,mBAAmB;GACnC,SAAS;GACT,GAAG;GACJ,CAAC,CAEe,OAAO,KAAK;;;;;;AAOjC,eAAsB,UACpB,MACA,SACwB;AAExB,QADgB,IAAI,YAAY,CACjB,OAAO,MAAM,QAAQ"}

package/dist/esm/encoder/error.js

@@ -0,0 +1,18 @@
+//#region src/encoder/error.ts
+/**
+* Error wrapper for encoder operations.
+*/
+var EncoderError = class extends Error {
+	code;
+	cause;
+	constructor(message, code, cause) {
+		super(message);
+		this.name = "EncoderError";
+		this.code = code;
+		this.cause = cause;
+	}
+};
+
+//#endregion
+export { EncoderError };
+//# sourceMappingURL=error.js.map

package/dist/esm/encoder/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","names":[],"sources":["../../../src/encoder/error.ts"],"sourcesContent":["/**\n * Error wrapper for encoder operations.\n */\nexport class EncoderError extends Error {\n  code: \"INVALID_JSON\" | \"INVALID_BASE64\" | \"INVALID_URL\" | \"INVALID_CSV\" | \"INVALID_TEXT\" | \"NETWORK_ERROR\" | \"UNKNOWN\";\n  cause?: Error;\n\n  constructor(\n    message: string,\n    code: EncoderError[\"code\"],\n    cause?: Error,\n  ) {\n    super(message);\n    this.name = \"EncoderError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n"],"mappings":";;;;AAGA,IAAa,eAAb,cAAkC,MAAM;CACtC;CACA;CAEA,YACE,SACA,MACA,OACA;AACA,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,QAAQ"}

package/dist/esm/encoder/index.js

@@ -0,0 +1,6 @@
+import { EncoderError } from "./error.js";
+import { JsonEncoder, jsonToFile } from "./json.js";
+import { Base64Encoder, base64ToFile } from "./base64.js";
+import { UrlEncoder, urlToFile } from "./url.js";
+import { CsvEncoder, csvToFile } from "./csv.js";
+import { TextEncoder, textToFile } from "./text.js";

package/dist/esm/encoder/json.js

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

package/dist/esm/encoder/json.js.map

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

package/dist/esm/encoder/text.js

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

package/dist/esm/encoder/text.js.map

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