emdash 0.0.0-a → 0.0.1

package/dist/seed/index.d.mts

@@ -0,0 +1,3 @@
+import "../types-DRjfYOEv.mjs";
+import { _ as SeedTaxonomyTerm, a as applySeed, b as ValidationResult, c as SeedCollection, d as SeedFile, f as SeedMenu, g as SeedTaxonomy, h as SeedSection, i as defaultSeed, l as SeedContentEntry, m as SeedRedirect, n as loadSeed, o as SeedApplyOptions, p as SeedMenuItem, r as loadUserSeed, s as SeedApplyResult, t as validateSeed, u as SeedField, v as SeedWidget, y as SeedWidgetArea } from "../validate-CpBtVMsD.mjs";
+export { type SeedApplyOptions, type SeedApplyResult, type SeedCollection, type SeedContentEntry, type SeedField, type SeedFile, type SeedMenu, type SeedMenuItem, type SeedRedirect, type SeedSection, type SeedTaxonomy, type SeedTaxonomyTerm, type SeedWidget, type SeedWidgetArea, type ValidationResult, applySeed, defaultSeed, loadSeed, loadUserSeed, validateSeed };

package/dist/seed/index.mjs

@@ -0,0 +1,15 @@
+import "../dialect-helpers-B9uSp2GJ.mjs";
+import "../content-D6C2WsZC.mjs";
+import "../base64-MBPo9ozB.mjs";
+import "../types-CMMN0pNg.mjs";
+import "../media-DqHVh136.mjs";
+import { t as applySeed } from "../apply-Bjfq_b4-.mjs";
+import "../registry-D_w5HW4G.mjs";
+import "../redirect-DIfIni3r.mjs";
+import "../byline-CL847F26.mjs";
+import "../loader-fz8Q_3EO.mjs";
+import { t as validateSeed } from "../validate-O7PWmlnq.mjs";
+import { t as defaultSeed } from "../default-Cyi4aAxu.mjs";
+import { n as loadUserSeed, t as loadSeed } from "../load-yOOlckBj.mjs";
+
+export { applySeed, defaultSeed, loadSeed, loadUserSeed, validateSeed };

package/dist/seo/index.d.mts

@@ -0,0 +1,70 @@
+import { i as ContentSeo } from "../types-BRuPJGdV.mjs";
+
+//#region src/seo/index.d.ts
+/**
+ * Content input for SEO functions.
+ * Accepts both ContentEntry<T> (from query functions) and ContentItem (internal).
+ */
+interface SeoContentInput<T = Record<string, unknown>> {
+  /** Content data object */
+  data: T & {
+    title?: unknown;
+    excerpt?: unknown;
+    seo?: ContentSeo;
+  };
+  /** SEO metadata (legacy location, prefer data.seo) */
+  seo?: ContentSeo;
+}
+/** Resolved SEO meta tags ready for use in templates */
+interface SeoMeta {
+  /** Full <title> tag content (e.g., "Post Title | Site Name") */
+  title: string;
+  /** Meta description */
+  description: string | null;
+  /** OG title (same as title by default) */
+  ogTitle: string;
+  /** OG description */
+  ogDescription: string | null;
+  /** OG image URL (absolute) */
+  ogImage: string | null;
+  /** Canonical URL */
+  canonical: string | null;
+  /** Robots directive (e.g., "noindex, nofollow") or null if default */
+  robots: string | null;
+}
+/** Options for generating SEO meta from a content item */
+interface SeoMetaOptions {
+  /** Site title for the suffix (e.g., "My Blog") */
+  siteTitle?: string;
+  /** Site URL origin for building absolute URLs (e.g., "https://example.com") */
+  siteUrl?: string;
+  /** Title separator between page title and site title */
+  titleSeparator?: string;
+  /** Path to this content (e.g., "/posts/my-post") for canonical fallback */
+  path?: string;
+  /** Default OG image URL if content has none */
+  defaultOgImage?: string;
+}
+/**
+ * Generate resolved SEO meta tags from a content item.
+ *
+ * Uses the content item's SEO fields, falling back to content data
+ * (title from `data.title`, description from `data.excerpt`).
+ *
+ * @param content - The content item (from getEmDashEntry, etc.)
+ * @param options - Configuration for title construction, canonical URLs, etc.
+ * @returns Resolved meta tags ready for template use
+ */
+declare function getSeoMeta<T>(content: SeoContentInput<T>, options?: SeoMetaOptions): SeoMeta;
+/**
+ * Extract SEO data from a content item.
+ *
+ * Convenience accessor for the raw SEO fields without template resolution.
+ *
+ * @param content - The content item
+ * @returns The content's SEO fields
+ */
+declare function getContentSeo<T>(content: SeoContentInput<T>): ContentSeo | undefined;
+//#endregion
+export { SeoContentInput, SeoMeta, SeoMetaOptions, getContentSeo, getSeoMeta };
+//# sourceMappingURL=index.d.mts.map

package/dist/seo/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/seo/index.ts"],"mappings":";;;;;;;UAwCiB,eAAA,KAAoB,MAAA;EA0B9B;EAxBN,IAAA,EAAM,CAAA;IACL,KAAA;IACA,OAAA;IACA,GAAA,GAAM,UAAA;EAAA;EA6BP;EA1BA,GAAA,GAAM,UAAA;AAAA;;UAIU,OAAA;EA4BF;EA1Bd,KAAA;EAuCyB;EArCzB,WAAA;EAqCsD;EAnCtD,OAAA;EAmCmE;EAjCnE,aAAA;EAiCgG;EA/BhG,OAAA;EA+B0B;EA7B1B,SAAA;EA6BsD;EA3BtD,MAAA;AAAA;;UAIgB,cAAA;EAuBgF;EArBhG,SAAA;EAsFe;EApFf,OAAA;EAoF4B;EAlF5B,cAAA;EAkFyC;EAhFzC,IAAA;EAgFwE;EA9ExE,cAAA;AAAA;;;;;;;;;;;iBAae,UAAA,GAAA,CAAc,OAAA,EAAS,eAAA,CAAgB,CAAA,GAAI,OAAA,GAAS,cAAA,GAAsB,OAAA;;;;;;;;;iBAiE1E,aAAA,GAAA,CAAiB,OAAA,EAAS,eAAA,CAAgB,CAAA,IAAK,UAAA"}

package/dist/seo/index.mjs

@@ -0,0 +1,70 @@
+//#region src/seo/index.ts
+const TRAILING_SLASH_RE = /\/$/;
+const ABSOLUTE_URL_RE = /^https?:\/\//i;
+/**
+* Generate resolved SEO meta tags from a content item.
+*
+* Uses the content item's SEO fields, falling back to content data
+* (title from `data.title`, description from `data.excerpt`).
+*
+* @param content - The content item (from getEmDashEntry, etc.)
+* @param options - Configuration for title construction, canonical URLs, etc.
+* @returns Resolved meta tags ready for template use
+*/
+function getSeoMeta(content, options = {}) {
+	const { siteTitle, siteUrl, path, defaultOgImage } = options;
+	const separator = options.titleSeparator || " | ";
+	const seo = content.seo ?? content.data.seo ?? {
+		title: null,
+		description: null,
+		image: null,
+		canonical: null,
+		noIndex: false
+	};
+	const pageTitle = seo.title || (typeof content.data.title === "string" ? content.data.title : null) || "";
+	const fullTitle = siteTitle && pageTitle ? `${pageTitle}${separator}${siteTitle}` : pageTitle;
+	const description = seo.description || (typeof content.data.excerpt === "string" ? content.data.excerpt : null) || null;
+	const ogImage = seo.image ? buildMediaUrl(seo.image, siteUrl) : defaultOgImage ?? null;
+	let canonical = null;
+	if (seo.canonical) if (siteUrl && !seo.canonical.startsWith("/") && !ABSOLUTE_URL_RE.test(seo.canonical)) canonical = `${siteUrl.replace(TRAILING_SLASH_RE, "")}/${seo.canonical}`;
+	else canonical = seo.canonical;
+	else if (siteUrl && path) {
+		const safePath = path.startsWith("/") ? path : `/${path}`;
+		canonical = `${siteUrl.replace(TRAILING_SLASH_RE, "")}${safePath}`;
+	}
+	const robots = seo.noIndex ? "noindex, nofollow" : null;
+	return {
+		title: fullTitle,
+		description,
+		ogTitle: pageTitle || fullTitle,
+		ogDescription: description,
+		ogImage,
+		canonical,
+		robots
+	};
+}
+/**
+* Extract SEO data from a content item.
+*
+* Convenience accessor for the raw SEO fields without template resolution.
+*
+* @param content - The content item
+* @returns The content's SEO fields
+*/
+function getContentSeo(content) {
+	return content.seo ?? content.data.seo;
+}
+/**
+* Build a media URL from a media reference ID.
+* If it's already an absolute URL, return as-is.
+*/
+function buildMediaUrl(imageRef, siteUrl) {
+	if (ABSOLUTE_URL_RE.test(imageRef)) return imageRef;
+	const mediaPath = `/_emdash/api/media/file/${imageRef}`;
+	if (siteUrl) return `${siteUrl.replace(TRAILING_SLASH_RE, "")}${mediaPath}`;
+	return mediaPath;
+}
+
+//#endregion
+export { getContentSeo, getSeoMeta };
+//# sourceMappingURL=index.mjs.map

package/dist/seo/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/seo/index.ts"],"sourcesContent":["/**\n * SEO Helpers\n *\n * Public API functions for generating SEO meta tags in Astro templates.\n *\n * @example\n * ```astro\n * ---\n * import { getEmDashEntry } from \"emdash\";\n * import { getSeoMeta } from \"emdash/seo\";\n *\n * const post = await getEmDashEntry(\"posts\", Astro.params.slug);\n * const meta = await getSeoMeta(post, {\n *   siteTitle: \"My Blog\",\n *   siteUrl: Astro.url.origin,\n * });\n * ---\n * <html>\n *   <head>\n *     <title>{meta.title}</title>\n *     <meta name=\"description\" content={meta.description} />\n *     <meta property=\"og:title\" content={meta.ogTitle} />\n *     <meta property=\"og:description\" content={meta.ogDescription} />\n *     {meta.ogImage && <meta property=\"og:image\" content={meta.ogImage} />}\n *     <link rel=\"canonical\" href={meta.canonical} />\n *     {meta.robots && <meta name=\"robots\" content={meta.robots} />}\n *   </head>\n * </html>\n * ```\n */\n\nimport type { ContentSeo } from \"../database/repositories/types.js\";\n\nconst TRAILING_SLASH_RE = /\\/$/;\nconst ABSOLUTE_URL_RE = /^https?:\\/\\//i;\n\n/**\n * Content input for SEO functions.\n * Accepts both ContentEntry<T> (from query functions) and ContentItem (internal).\n */\nexport interface SeoContentInput<T = Record<string, unknown>> {\n\t/** Content data object */\n\tdata: T & {\n\t\ttitle?: unknown;\n\t\texcerpt?: unknown;\n\t\tseo?: ContentSeo;\n\t};\n\t/** SEO metadata (legacy location, prefer data.seo) */\n\tseo?: ContentSeo;\n}\n\n/** Resolved SEO meta tags ready for use in templates */\nexport interface SeoMeta {\n\t/** Full <title> tag content (e.g., \"Post Title | Site Name\") */\n\ttitle: string;\n\t/** Meta description */\n\tdescription: string | null;\n\t/** OG title (same as title by default) */\n\togTitle: string;\n\t/** OG description */\n\togDescription: string | null;\n\t/** OG image URL (absolute) */\n\togImage: string | null;\n\t/** Canonical URL */\n\tcanonical: string | null;\n\t/** Robots directive (e.g., \"noindex, nofollow\") or null if default */\n\trobots: string | null;\n}\n\n/** Options for generating SEO meta from a content item */\nexport interface SeoMetaOptions {\n\t/** Site title for the suffix (e.g., \"My Blog\") */\n\tsiteTitle?: string;\n\t/** Site URL origin for building absolute URLs (e.g., \"https://example.com\") */\n\tsiteUrl?: string;\n\t/** Title separator between page title and site title */\n\ttitleSeparator?: string;\n\t/** Path to this content (e.g., \"/posts/my-post\") for canonical fallback */\n\tpath?: string;\n\t/** Default OG image URL if content has none */\n\tdefaultOgImage?: string;\n}\n\n/**\n * Generate resolved SEO meta tags from a content item.\n *\n * Uses the content item's SEO fields, falling back to content data\n * (title from `data.title`, description from `data.excerpt`).\n *\n * @param content - The content item (from getEmDashEntry, etc.)\n * @param options - Configuration for title construction, canonical URLs, etc.\n * @returns Resolved meta tags ready for template use\n */\nexport function getSeoMeta<T>(content: SeoContentInput<T>, options: SeoMetaOptions = {}): SeoMeta {\n\tconst { siteTitle, siteUrl, path, defaultOgImage } = options;\n\tconst separator = options.titleSeparator || \" | \";\n\t// SEO can be in content.seo (ContentItem) or content.data.seo (ContentEntry)\n\tconst seo = content.seo ??\n\t\tcontent.data.seo ?? {\n\t\t\ttitle: null,\n\t\t\tdescription: null,\n\t\t\timage: null,\n\t\t\tcanonical: null,\n\t\t\tnoIndex: false,\n\t\t};\n\n\t// Title: SEO title > content title > fallback\n\tconst pageTitle =\n\t\tseo.title || (typeof content.data.title === \"string\" ? content.data.title : null) || \"\";\n\n\tconst fullTitle = siteTitle && pageTitle ? `${pageTitle}${separator}${siteTitle}` : pageTitle;\n\n\t// Description: SEO description > excerpt\n\tconst description =\n\t\tseo.description ||\n\t\t(typeof content.data.excerpt === \"string\" ? content.data.excerpt : null) ||\n\t\tnull;\n\n\t// OG image: SEO image > default\n\tconst ogImage = seo.image ? buildMediaUrl(seo.image, siteUrl) : (defaultOgImage ?? null);\n\n\t// Canonical: explicit > path-based > null\n\tlet canonical: string | null = null;\n\tif (seo.canonical) {\n\t\t// Ensure relative canonical paths get a leading slash so we don't\n\t\t// produce \"https://example.composts/x\" when joined with siteUrl\n\t\tif (siteUrl && !seo.canonical.startsWith(\"/\") && !ABSOLUTE_URL_RE.test(seo.canonical)) {\n\t\t\tcanonical = `${siteUrl.replace(TRAILING_SLASH_RE, \"\")}/${seo.canonical}`;\n\t\t} else {\n\t\t\tcanonical = seo.canonical;\n\t\t}\n\t} else if (siteUrl && path) {\n\t\tconst safePath = path.startsWith(\"/\") ? path : `/${path}`;\n\t\tcanonical = `${siteUrl.replace(TRAILING_SLASH_RE, \"\")}${safePath}`;\n\t}\n\n\t// Robots\n\tconst robots = seo.noIndex ? \"noindex, nofollow\" : null;\n\n\treturn {\n\t\ttitle: fullTitle,\n\t\tdescription,\n\t\togTitle: pageTitle || fullTitle,\n\t\togDescription: description,\n\t\togImage,\n\t\tcanonical,\n\t\trobots,\n\t};\n}\n\n/**\n * Extract SEO data from a content item.\n *\n * Convenience accessor for the raw SEO fields without template resolution.\n *\n * @param content - The content item\n * @returns The content's SEO fields\n */\nexport function getContentSeo<T>(content: SeoContentInput<T>): ContentSeo | undefined {\n\treturn content.seo ?? content.data.seo;\n}\n\n/**\n * Build a media URL from a media reference ID.\n * If it's already an absolute URL, return as-is.\n */\nfunction buildMediaUrl(imageRef: string, siteUrl?: string): string {\n\t// If already an absolute URL, return as-is\n\tif (ABSOLUTE_URL_RE.test(imageRef)) {\n\t\treturn imageRef;\n\t}\n\n\t// Build from media API path\n\tconst mediaPath = `/_emdash/api/media/file/${imageRef}`;\n\tif (siteUrl) {\n\t\treturn `${siteUrl.replace(TRAILING_SLASH_RE, \"\")}${mediaPath}`;\n\t}\n\treturn mediaPath;\n}\n"],"mappings":";AAiCA,MAAM,oBAAoB;AAC1B,MAAM,kBAAkB;;;;;;;;;;;AA2DxB,SAAgB,WAAc,SAA6B,UAA0B,EAAE,EAAW;CACjG,MAAM,EAAE,WAAW,SAAS,MAAM,mBAAmB;CACrD,MAAM,YAAY,QAAQ,kBAAkB;CAE5C,MAAM,MAAM,QAAQ,OACnB,QAAQ,KAAK,OAAO;EACnB,OAAO;EACP,aAAa;EACb,OAAO;EACP,WAAW;EACX,SAAS;EACT;CAGF,MAAM,YACL,IAAI,UAAU,OAAO,QAAQ,KAAK,UAAU,WAAW,QAAQ,KAAK,QAAQ,SAAS;CAEtF,MAAM,YAAY,aAAa,YAAY,GAAG,YAAY,YAAY,cAAc;CAGpF,MAAM,cACL,IAAI,gBACH,OAAO,QAAQ,KAAK,YAAY,WAAW,QAAQ,KAAK,UAAU,SACnE;CAGD,MAAM,UAAU,IAAI,QAAQ,cAAc,IAAI,OAAO,QAAQ,GAAI,kBAAkB;CAGnF,IAAI,YAA2B;AAC/B,KAAI,IAAI,UAGP,KAAI,WAAW,CAAC,IAAI,UAAU,WAAW,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,UAAU,CACpF,aAAY,GAAG,QAAQ,QAAQ,mBAAmB,GAAG,CAAC,GAAG,IAAI;KAE7D,aAAY,IAAI;UAEP,WAAW,MAAM;EAC3B,MAAM,WAAW,KAAK,WAAW,IAAI,GAAG,OAAO,IAAI;AACnD,cAAY,GAAG,QAAQ,QAAQ,mBAAmB,GAAG,GAAG;;CAIzD,MAAM,SAAS,IAAI,UAAU,sBAAsB;AAEnD,QAAO;EACN,OAAO;EACP;EACA,SAAS,aAAa;EACtB,eAAe;EACf;EACA;EACA;EACA;;;;;;;;;;AAWF,SAAgB,cAAiB,SAAqD;AACrF,QAAO,QAAQ,OAAO,QAAQ,KAAK;;;;;;AAOpC,SAAS,cAAc,UAAkB,SAA0B;AAElE,KAAI,gBAAgB,KAAK,SAAS,CACjC,QAAO;CAIR,MAAM,YAAY,2BAA2B;AAC7C,KAAI,QACH,QAAO,GAAG,QAAQ,QAAQ,mBAAmB,GAAG,GAAG;AAEpD,QAAO"}

package/dist/storage/local.d.mts

@@ -0,0 +1,39 @@
+import { a as ListOptions, d as Storage, l as SignedUploadOptions, n as DownloadResult, o as ListResult, p as UploadResult, s as LocalStorageConfig, u as SignedUploadUrl } from "../types-DaNLHo_T.mjs";
+
+//#region src/storage/local.d.ts
+/**
+ * Local filesystem storage implementation
+ */
+declare class LocalStorage implements Storage {
+  /** Resolved absolute base directory for all stored files */
+  private directory;
+  private baseUrl;
+  constructor(config: LocalStorageConfig);
+  /**
+   * Resolve a storage key to an absolute file path, ensuring it stays
+   * within the configured storage directory. Uses path.resolve() for
+   * canonical resolution rather than regex stripping.
+   *
+   * @throws EmDashStorageError if the resolved path escapes the base directory
+   */
+  private getFilePath;
+  upload(options: {
+    key: string;
+    body: Buffer | Uint8Array | ReadableStream<Uint8Array>;
+    contentType: string;
+  }): Promise<UploadResult>;
+  download(key: string): Promise<DownloadResult>;
+  delete(key: string): Promise<void>;
+  exists(key: string): Promise<boolean>;
+  list(options?: ListOptions): Promise<ListResult>;
+  getSignedUploadUrl(_options: SignedUploadOptions): Promise<SignedUploadUrl>;
+  getPublicUrl(key: string): string;
+}
+/**
+ * Create local storage adapter
+ * This is the factory function called at runtime
+ */
+declare function createStorage(config: Record<string, unknown>): Storage;
+//#endregion
+export { LocalStorage, createStorage };
+//# sourceMappingURL=local.d.mts.map

package/dist/storage/local.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.mts","names":[],"sources":["../../src/storage/local.ts"],"mappings":";;;;;;cAuCa,YAAA,YAAwB,OAAA;EA+BP;EAAA,QA7BrB,SAAA;EAAA,QACA,OAAA;cAEI,MAAA,EAAQ,kBAAA;EAqES;;;;;;;EAAA,QAzDrB,WAAA;EAYF,MAAA,CAAO,OAAA;IACZ,GAAA;IACA,IAAA,EAAM,MAAA,GAAS,UAAA,GAAa,cAAA,CAAe,UAAA;IAC3C,WAAA;EAAA,IACG,OAAA,CAAQ,YAAA;EAyCN,QAAA,CAAS,GAAA,WAAc,OAAA,CAAQ,cAAA;EAkC/B,MAAA,CAAO,GAAA,WAAc,OAAA;EAYrB,MAAA,CAAO,GAAA,WAAc,OAAA;EAUrB,IAAA,CAAK,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,UAAA;EAsDzC,kBAAA,CAAmB,QAAA,EAAU,mBAAA,GAAsB,OAAA,CAAQ,eAAA;EASjE,YAAA,CAAa,GAAA;AAAA;;;;;iBAgBE,aAAA,CAAc,MAAA,EAAQ,MAAA,oBAA0B,OAAA"}

package/dist/storage/local.mjs

@@ -0,0 +1,166 @@
+import { t as EmDashStorageError } from "../types-CUBbjgmP.mjs";
+import mime from "mime/lite";
+import * as path from "node:path";
+import { createReadStream, existsSync } from "node:fs";
+import * as fs from "node:fs/promises";
+import { Readable } from "node:stream";
+
+//#region src/storage/local.ts
+/**
+* Local Filesystem Storage Implementation
+*
+* For development and testing. Stores files in a local directory.
+*/
+/** Type guard for Node.js ErrnoException */
+function isNodeError(error) {
+	return error instanceof Error && "code" in error;
+}
+/** Pattern to remove leading slashes */
+const LEADING_SLASH_PATTERN = /^\//;
+/** Pattern to remove trailing slashes */
+const TRAILING_SLASH_PATTERN = /\/$/;
+/**
+* Local filesystem storage implementation
+*/
+var LocalStorage = class {
+	/** Resolved absolute base directory for all stored files */
+	directory;
+	baseUrl;
+	constructor(config) {
+		this.directory = path.resolve(config.directory);
+		this.baseUrl = config.baseUrl.replace(TRAILING_SLASH_PATTERN, "");
+	}
+	/**
+	* Resolve a storage key to an absolute file path, ensuring it stays
+	* within the configured storage directory. Uses path.resolve() for
+	* canonical resolution rather than regex stripping.
+	*
+	* @throws EmDashStorageError if the resolved path escapes the base directory
+	*/
+	getFilePath(key) {
+		const normalizedKey = key.replace(LEADING_SLASH_PATTERN, "");
+		const resolved = path.resolve(this.directory, normalizedKey);
+		if (!resolved.startsWith(this.directory + path.sep) && resolved !== this.directory) throw new EmDashStorageError("Invalid file path", "INVALID_PATH");
+		return resolved;
+	}
+	async upload(options) {
+		try {
+			const filePath = this.getFilePath(options.key);
+			const dir = path.dirname(filePath);
+			await fs.mkdir(dir, { recursive: true });
+			let buffer;
+			if (options.body instanceof ReadableStream) {
+				const chunks = [];
+				const reader = options.body.getReader();
+				while (true) {
+					const { done, value } = await reader.read();
+					if (done) break;
+					chunks.push(value);
+				}
+				buffer = Buffer.concat(chunks);
+			} else if (options.body instanceof Uint8Array) buffer = Buffer.from(options.body);
+			else buffer = options.body;
+			await fs.writeFile(filePath, buffer);
+			return {
+				key: options.key,
+				url: this.getPublicUrl(options.key),
+				size: buffer.length
+			};
+		} catch (error) {
+			throw new EmDashStorageError(`Failed to upload file: ${options.key}`, "UPLOAD_FAILED", error);
+		}
+	}
+	async download(key) {
+		try {
+			const filePath = this.getFilePath(key);
+			if (!existsSync(filePath)) throw new EmDashStorageError(`File not found: ${key}`, "NOT_FOUND");
+			const stat = await fs.stat(filePath);
+			const nodeStream = createReadStream(filePath);
+			return {
+				body: Readable.toWeb(nodeStream),
+				contentType: getContentType(path.extname(key).toLowerCase()),
+				size: stat.size
+			};
+		} catch (error) {
+			if (error instanceof EmDashStorageError) throw error;
+			throw new EmDashStorageError(`Failed to download file: ${key}`, "DOWNLOAD_FAILED", error);
+		}
+	}
+	async delete(key) {
+		try {
+			const filePath = this.getFilePath(key);
+			await fs.unlink(filePath);
+		} catch (error) {
+			if (!isNodeError(error) || error.code !== "ENOENT") throw new EmDashStorageError(`Failed to delete file: ${key}`, "DELETE_FAILED", error);
+		}
+	}
+	async exists(key) {
+		try {
+			const filePath = this.getFilePath(key);
+			await fs.access(filePath);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async list(options = {}) {
+		try {
+			const prefix = options.prefix || "";
+			const searchDir = path.resolve(this.directory, path.dirname(prefix));
+			if (!searchDir.startsWith(this.directory + path.sep) && searchDir !== this.directory) throw new EmDashStorageError("Invalid list prefix", "INVALID_PATH");
+			const prefixBase = path.basename(prefix);
+			try {
+				await fs.access(searchDir);
+			} catch {
+				return { files: [] };
+			}
+			const entries = await fs.readdir(searchDir, { withFileTypes: true });
+			const files = [];
+			for (const entry of entries) if (entry.isFile() && entry.name.startsWith(prefixBase)) {
+				const key = path.join(path.dirname(prefix), entry.name);
+				const filePath = path.join(searchDir, entry.name);
+				const stat = await fs.stat(filePath);
+				files.push({
+					key,
+					size: stat.size,
+					lastModified: stat.mtime
+				});
+			}
+			files.sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());
+			const startIndex = options.cursor ? parseInt(options.cursor, 10) : 0;
+			const limit = options.limit || 1e3;
+			return {
+				files: files.slice(startIndex, startIndex + limit),
+				nextCursor: startIndex + limit < files.length ? String(startIndex + limit) : void 0
+			};
+		} catch (error) {
+			throw new EmDashStorageError("Failed to list files", "LIST_FAILED", error);
+		}
+	}
+	async getSignedUploadUrl(_options) {
+		throw new EmDashStorageError("Local storage does not support signed upload URLs. Upload files directly through the API.", "NOT_SUPPORTED");
+	}
+	getPublicUrl(key) {
+		return `${this.baseUrl}/${key}`;
+	}
+};
+/**
+* Get content type from file extension
+*/
+function getContentType(ext) {
+	return mime.getType(ext) ?? "application/octet-stream";
+}
+/**
+* Create local storage adapter
+* This is the factory function called at runtime
+*/
+function createStorage(config) {
+	return new LocalStorage({
+		directory: typeof config.directory === "string" ? config.directory : "",
+		baseUrl: typeof config.baseUrl === "string" ? config.baseUrl : ""
+	});
+}
+
+//#endregion
+export { LocalStorage, createStorage };
+//# sourceMappingURL=local.mjs.map

package/dist/storage/local.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.mjs","names":[],"sources":["../../src/storage/local.ts"],"sourcesContent":["/**\n * Local Filesystem Storage Implementation\n *\n * For development and testing. Stores files in a local directory.\n */\n\nimport { createReadStream, existsSync } from \"node:fs\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { Readable } from \"node:stream\";\n\nimport mime from \"mime/lite\";\n\n/** Type guard for Node.js ErrnoException */\nfunction isNodeError(error: unknown): error is NodeJS.ErrnoException {\n\treturn error instanceof Error && \"code\" in error;\n}\n\nimport type {\n\tStorage,\n\tLocalStorageConfig,\n\tUploadResult,\n\tDownloadResult,\n\tListResult,\n\tListOptions,\n\tSignedUploadUrl,\n\tSignedUploadOptions,\n} from \"./types.js\";\nimport { EmDashStorageError } from \"./types.js\";\n\n/** Pattern to remove leading slashes */\nconst LEADING_SLASH_PATTERN = /^\\//;\n\n/** Pattern to remove trailing slashes */\nconst TRAILING_SLASH_PATTERN = /\\/$/;\n\n/**\n * Local filesystem storage implementation\n */\nexport class LocalStorage implements Storage {\n\t/** Resolved absolute base directory for all stored files */\n\tprivate directory: string;\n\tprivate baseUrl: string;\n\n\tconstructor(config: LocalStorageConfig) {\n\t\tthis.directory = path.resolve(config.directory);\n\t\tthis.baseUrl = config.baseUrl.replace(TRAILING_SLASH_PATTERN, \"\");\n\t}\n\n\t/**\n\t * Resolve a storage key to an absolute file path, ensuring it stays\n\t * within the configured storage directory. Uses path.resolve() for\n\t * canonical resolution rather than regex stripping.\n\t *\n\t * @throws EmDashStorageError if the resolved path escapes the base directory\n\t */\n\tprivate getFilePath(key: string): string {\n\t\tconst normalizedKey = key.replace(LEADING_SLASH_PATTERN, \"\");\n\t\tconst resolved = path.resolve(this.directory, normalizedKey);\n\n\t\t// Verify the resolved path is within the base directory\n\t\tif (!resolved.startsWith(this.directory + path.sep) && resolved !== this.directory) {\n\t\t\tthrow new EmDashStorageError(\"Invalid file path\", \"INVALID_PATH\");\n\t\t}\n\n\t\treturn resolved;\n\t}\n\n\tasync upload(options: {\n\t\tkey: string;\n\t\tbody: Buffer | Uint8Array | ReadableStream<Uint8Array>;\n\t\tcontentType: string;\n\t}): Promise<UploadResult> {\n\t\ttry {\n\t\t\tconst filePath = this.getFilePath(options.key);\n\t\t\tconst dir = path.dirname(filePath);\n\n\t\t\t// Ensure directory exists\n\t\t\tawait fs.mkdir(dir, { recursive: true });\n\n\t\t\t// Convert body to buffer\n\t\t\tlet buffer: Buffer;\n\t\t\tif (options.body instanceof ReadableStream) {\n\t\t\t\tconst chunks: Uint8Array[] = [];\n\t\t\t\tconst reader = options.body.getReader();\n\t\t\t\twhile (true) {\n\t\t\t\t\tconst { done, value } = await reader.read();\n\t\t\t\t\tif (done) break;\n\t\t\t\t\tchunks.push(value);\n\t\t\t\t}\n\t\t\t\tbuffer = Buffer.concat(chunks);\n\t\t\t} else if (options.body instanceof Uint8Array) {\n\t\t\t\tbuffer = Buffer.from(options.body);\n\t\t\t} else {\n\t\t\t\tbuffer = options.body;\n\t\t\t}\n\n\t\t\tawait fs.writeFile(filePath, buffer);\n\n\t\t\treturn {\n\t\t\t\tkey: options.key,\n\t\t\t\turl: this.getPublicUrl(options.key),\n\t\t\t\tsize: buffer.length,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tthrow new EmDashStorageError(\n\t\t\t\t`Failed to upload file: ${options.key}`,\n\t\t\t\t\"UPLOAD_FAILED\",\n\t\t\t\terror,\n\t\t\t);\n\t\t}\n\t}\n\n\tasync download(key: string): Promise<DownloadResult> {\n\t\ttry {\n\t\t\tconst filePath = this.getFilePath(key);\n\n\t\t\tif (!existsSync(filePath)) {\n\t\t\t\tthrow new EmDashStorageError(`File not found: ${key}`, \"NOT_FOUND\");\n\t\t\t}\n\n\t\t\tconst stat = await fs.stat(filePath);\n\t\t\tconst nodeStream = createReadStream(filePath);\n\n\t\t\t// Convert Node.js stream to web ReadableStream\n\t\t\t// Readable.toWeb returns ReadableStream (which is ReadableStream<unknown>),\n\t\t\t// but Node ReadStreams produce Buffer/Uint8Array chunks\n\t\t\t// eslint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- Readable.toWeb returns ReadableStream<unknown>; Node ReadStreams produce Uint8Array chunks\n\t\t\tconst webStream: ReadableStream<Uint8Array> = Readable.toWeb(\n\t\t\t\tnodeStream,\n\t\t\t) as ReadableStream<Uint8Array>;\n\n\t\t\t// Infer content type from extension\n\t\t\tconst ext = path.extname(key).toLowerCase();\n\t\t\tconst contentType = getContentType(ext);\n\n\t\t\treturn {\n\t\t\t\tbody: webStream,\n\t\t\t\tcontentType,\n\t\t\t\tsize: stat.size,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tif (error instanceof EmDashStorageError) throw error;\n\t\t\tthrow new EmDashStorageError(`Failed to download file: ${key}`, \"DOWNLOAD_FAILED\", error);\n\t\t}\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\ttry {\n\t\t\tconst filePath = this.getFilePath(key);\n\t\t\tawait fs.unlink(filePath);\n\t\t} catch (error) {\n\t\t\t// Ignore \"file not found\" errors (idempotent delete)\n\t\t\tif (!isNodeError(error) || error.code !== \"ENOENT\") {\n\t\t\t\tthrow new EmDashStorageError(`Failed to delete file: ${key}`, \"DELETE_FAILED\", error);\n\t\t\t}\n\t\t}\n\t}\n\n\tasync exists(key: string): Promise<boolean> {\n\t\ttry {\n\t\t\tconst filePath = this.getFilePath(key);\n\t\t\tawait fs.access(filePath);\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync list(options: ListOptions = {}): Promise<ListResult> {\n\t\ttry {\n\t\t\tconst prefix = options.prefix || \"\";\n\t\t\tconst searchDir = path.resolve(this.directory, path.dirname(prefix));\n\n\t\t\t// Validate the search directory stays within the base directory\n\t\t\tif (!searchDir.startsWith(this.directory + path.sep) && searchDir !== this.directory) {\n\t\t\t\tthrow new EmDashStorageError(\"Invalid list prefix\", \"INVALID_PATH\");\n\t\t\t}\n\n\t\t\tconst prefixBase = path.basename(prefix);\n\n\t\t\t// Ensure directory exists\n\t\t\ttry {\n\t\t\t\tawait fs.access(searchDir);\n\t\t\t} catch {\n\t\t\t\treturn { files: [] };\n\t\t\t}\n\n\t\t\tconst entries = await fs.readdir(searchDir, { withFileTypes: true });\n\t\t\tconst files: ListResult[\"files\"] = [];\n\n\t\t\tfor (const entry of entries) {\n\t\t\t\tif (entry.isFile() && entry.name.startsWith(prefixBase)) {\n\t\t\t\t\tconst key = path.join(path.dirname(prefix), entry.name);\n\t\t\t\t\tconst filePath = path.join(searchDir, entry.name);\n\t\t\t\t\tconst stat = await fs.stat(filePath);\n\n\t\t\t\t\tfiles.push({\n\t\t\t\t\t\tkey,\n\t\t\t\t\t\tsize: stat.size,\n\t\t\t\t\t\tlastModified: stat.mtime,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Sort by last modified (newest first)\n\t\t\tfiles.sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());\n\n\t\t\t// Apply limit and cursor (simple implementation)\n\t\t\tconst startIndex = options.cursor ? parseInt(options.cursor, 10) : 0;\n\t\t\tconst limit = options.limit || 1000;\n\t\t\tconst paginatedFiles = files.slice(startIndex, startIndex + limit);\n\t\t\tconst hasMore = startIndex + limit < files.length;\n\n\t\t\treturn {\n\t\t\t\tfiles: paginatedFiles,\n\t\t\t\tnextCursor: hasMore ? String(startIndex + limit) : undefined,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tthrow new EmDashStorageError(\"Failed to list files\", \"LIST_FAILED\", error);\n\t\t}\n\t}\n\n\tasync getSignedUploadUrl(_options: SignedUploadOptions): Promise<SignedUploadUrl> {\n\t\t// Local storage doesn't support signed URLs\n\t\tthrow new EmDashStorageError(\n\t\t\t\"Local storage does not support signed upload URLs. \" +\n\t\t\t\t\"Upload files directly through the API.\",\n\t\t\t\"NOT_SUPPORTED\",\n\t\t);\n\t}\n\n\tgetPublicUrl(key: string): string {\n\t\treturn `${this.baseUrl}/${key}`;\n\t}\n}\n\n/**\n * Get content type from file extension\n */\nfunction getContentType(ext: string): string {\n\treturn mime.getType(ext) ?? \"application/octet-stream\";\n}\n\n/**\n * Create local storage adapter\n * This is the factory function called at runtime\n */\nexport function createStorage(config: Record<string, unknown>): Storage {\n\tconst directory = typeof config.directory === \"string\" ? config.directory : \"\";\n\tconst baseUrl = typeof config.baseUrl === \"string\" ? config.baseUrl : \"\";\n\treturn new LocalStorage({ directory, baseUrl });\n}\n"],"mappings":"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"}

package/dist/storage/s3.d.mts

@@ -0,0 +1,32 @@
+import { a as ListOptions, c as S3StorageConfig, d as Storage, l as SignedUploadOptions, n as DownloadResult, o as ListResult, p as UploadResult, u as SignedUploadUrl } from "../types-DaNLHo_T.mjs";
+
+//#region src/storage/s3.d.ts
+/**
+ * S3-compatible storage implementation
+ */
+declare class S3Storage implements Storage {
+  private client;
+  private bucket;
+  private publicUrl?;
+  private endpoint;
+  constructor(config: S3StorageConfig);
+  upload(options: {
+    key: string;
+    body: Buffer | Uint8Array | ReadableStream<Uint8Array>;
+    contentType: string;
+  }): Promise<UploadResult>;
+  download(key: string): Promise<DownloadResult>;
+  delete(key: string): Promise<void>;
+  exists(key: string): Promise<boolean>;
+  list(options?: ListOptions): Promise<ListResult>;
+  getSignedUploadUrl(options: SignedUploadOptions): Promise<SignedUploadUrl>;
+  getPublicUrl(key: string): string;
+}
+/**
+ * Create S3 storage adapter
+ * This is the factory function called at runtime
+ */
+declare function createStorage(config: Record<string, unknown>): Storage;
+//#endregion
+export { S3Storage, createStorage };
+//# sourceMappingURL=s3.d.mts.map

package/dist/storage/s3.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.mts","names":[],"sources":["../../src/storage/s3.ts"],"mappings":";;;;;;cAwCa,SAAA,YAAqB,OAAA;EAAA,QACzB,MAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;EAAA,QACA,QAAA;cAEI,MAAA,EAAQ,eAAA;EAiBd,MAAA,CAAO,OAAA;IACZ,GAAA;IACA,IAAA,EAAM,MAAA,GAAS,UAAA,GAAa,cAAA,CAAe,UAAA;IAC3C,WAAA;EAAA,IACG,OAAA,CAAQ,YAAA;EAwCN,QAAA,CAAS,GAAA,WAAc,OAAA,CAAQ,cAAA;EAgC/B,MAAA,CAAO,GAAA,WAAc,OAAA;EAgBrB,MAAA,CAAO,GAAA,WAAc,OAAA;EAqBrB,IAAA,CAAK,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,UAAA;EA4BzC,kBAAA,CAAmB,OAAA,EAAS,mBAAA,GAAsB,OAAA,CAAQ,eAAA;EAiChE,YAAA,CAAa,GAAA;AAAA;;;;;iBAaE,aAAA,CAAc,MAAA,EAAQ,MAAA,oBAA0B,OAAA"}

package/dist/storage/s3.mjs

@@ -0,0 +1,175 @@
+import { t as EmDashStorageError } from "../types-CUBbjgmP.mjs";
+import { DeleteObjectCommand, GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
+
+//#region src/storage/s3.ts
+/**
+* S3-Compatible Storage Implementation
+*
+* Uses the AWS SDK v3 for S3 operations.
+* Works with AWS S3, Cloudflare R2, Minio, and other S3-compatible services.
+*/
+const TRAILING_SLASH_PATTERN = /\/$/;
+/** Type guard for AWS SDK errors (have a `name` property) */
+function hasErrorName(error) {
+	return error instanceof Error && typeof error.name === "string";
+}
+/**
+* S3-compatible storage implementation
+*/
+var S3Storage = class {
+	client;
+	bucket;
+	publicUrl;
+	endpoint;
+	constructor(config) {
+		this.bucket = config.bucket;
+		this.publicUrl = config.publicUrl;
+		this.endpoint = config.endpoint;
+		this.client = new S3Client({
+			endpoint: config.endpoint,
+			region: config.region || "auto",
+			credentials: {
+				accessKeyId: config.accessKeyId,
+				secretAccessKey: config.secretAccessKey
+			},
+			forcePathStyle: true
+		});
+	}
+	async upload(options) {
+		try {
+			let body;
+			if (options.body instanceof ReadableStream) {
+				const chunks = [];
+				const reader = options.body.getReader();
+				while (true) {
+					const { done, value } = await reader.read();
+					if (done) break;
+					chunks.push(value);
+				}
+				body = Buffer.concat(chunks);
+			} else body = options.body;
+			await this.client.send(new PutObjectCommand({
+				Bucket: this.bucket,
+				Key: options.key,
+				Body: body,
+				ContentType: options.contentType
+			}));
+			return {
+				key: options.key,
+				url: this.getPublicUrl(options.key),
+				size: body.length
+			};
+		} catch (error) {
+			throw new EmDashStorageError(`Failed to upload file: ${options.key}`, "UPLOAD_FAILED", error);
+		}
+	}
+	async download(key) {
+		try {
+			const response = await this.client.send(new GetObjectCommand({
+				Bucket: this.bucket,
+				Key: key
+			}));
+			if (!response.Body) throw new EmDashStorageError(`File not found: ${key}`, "NOT_FOUND");
+			return {
+				body: response.Body.transformToWebStream(),
+				contentType: response.ContentType || "application/octet-stream",
+				size: response.ContentLength || 0
+			};
+		} catch (error) {
+			if (error instanceof EmDashStorageError || hasErrorName(error) && error.name === "NoSuchKey") throw new EmDashStorageError(`File not found: ${key}`, "NOT_FOUND", error);
+			throw new EmDashStorageError(`Failed to download file: ${key}`, "DOWNLOAD_FAILED", error);
+		}
+	}
+	async delete(key) {
+		try {
+			await this.client.send(new DeleteObjectCommand({
+				Bucket: this.bucket,
+				Key: key
+			}));
+		} catch (error) {
+			if (!hasErrorName(error) || error.name !== "NoSuchKey") throw new EmDashStorageError(`Failed to delete file: ${key}`, "DELETE_FAILED", error);
+		}
+	}
+	async exists(key) {
+		try {
+			await this.client.send(new HeadObjectCommand({
+				Bucket: this.bucket,
+				Key: key
+			}));
+			return true;
+		} catch (error) {
+			if (hasErrorName(error) && error.name === "NotFound") return false;
+			throw new EmDashStorageError(`Failed to check file existence: ${key}`, "HEAD_FAILED", error);
+		}
+	}
+	async list(options = {}) {
+		try {
+			const response = await this.client.send(new ListObjectsV2Command({
+				Bucket: this.bucket,
+				Prefix: options.prefix,
+				MaxKeys: options.limit,
+				ContinuationToken: options.cursor
+			}));
+			return {
+				files: (response.Contents || []).map((item) => ({
+					key: item.Key,
+					size: item.Size || 0,
+					lastModified: item.LastModified || /* @__PURE__ */ new Date(),
+					etag: item.ETag
+				})),
+				nextCursor: response.NextContinuationToken
+			};
+		} catch (error) {
+			throw new EmDashStorageError("Failed to list files", "LIST_FAILED", error);
+		}
+	}
+	async getSignedUploadUrl(options) {
+		try {
+			const expiresIn = options.expiresIn || 3600;
+			const command = new PutObjectCommand({
+				Bucket: this.bucket,
+				Key: options.key,
+				ContentType: options.contentType,
+				ContentLength: options.size
+			});
+			const url = await getSignedUrl(this.client, command, { expiresIn });
+			const expiresAt = new Date(Date.now() + expiresIn * 1e3).toISOString();
+			return {
+				url,
+				method: "PUT",
+				headers: {
+					"Content-Type": options.contentType,
+					...options.size ? { "Content-Length": String(options.size) } : {}
+				},
+				expiresAt
+			};
+		} catch (error) {
+			throw new EmDashStorageError(`Failed to generate signed URL for: ${options.key}`, "SIGNED_URL_FAILED", error);
+		}
+	}
+	getPublicUrl(key) {
+		if (this.publicUrl) return `${this.publicUrl.replace(TRAILING_SLASH_PATTERN, "")}/${key}`;
+		return `${this.endpoint.replace(TRAILING_SLASH_PATTERN, "")}/${this.bucket}/${key}`;
+	}
+};
+/**
+* Create S3 storage adapter
+* This is the factory function called at runtime
+*/
+function createStorage(config) {
+	const { endpoint, bucket, accessKeyId, secretAccessKey, region, publicUrl } = config;
+	if (typeof endpoint !== "string" || typeof bucket !== "string" || typeof accessKeyId !== "string" || typeof secretAccessKey !== "string") throw new Error("S3Storage requires 'endpoint', 'bucket', 'accessKeyId', and 'secretAccessKey' string config values");
+	return new S3Storage({
+		endpoint,
+		bucket,
+		accessKeyId,
+		secretAccessKey,
+		region: typeof region === "string" ? region : void 0,
+		publicUrl: typeof publicUrl === "string" ? publicUrl : void 0
+	});
+}
+
+//#endregion
+export { S3Storage, createStorage };
+//# sourceMappingURL=s3.mjs.map

package/dist/storage/s3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.mjs","names":[],"sources":["../../src/storage/s3.ts"],"sourcesContent":["/**\n * S3-Compatible Storage Implementation\n *\n * Uses the AWS SDK v3 for S3 operations.\n * Works with AWS S3, Cloudflare R2, Minio, and other S3-compatible services.\n */\n\nimport {\n\tS3Client,\n\tPutObjectCommand,\n\tGetObjectCommand,\n\tDeleteObjectCommand,\n\tHeadObjectCommand,\n\tListObjectsV2Command,\n\ttype ListObjectsV2Response,\n} from \"@aws-sdk/client-s3\";\nimport { getSignedUrl } from \"@aws-sdk/s3-request-presigner\";\n\nimport type {\n\tStorage,\n\tS3StorageConfig,\n\tUploadResult,\n\tDownloadResult,\n\tListResult,\n\tListOptions,\n\tSignedUploadUrl,\n\tSignedUploadOptions,\n} from \"./types.js\";\nimport { EmDashStorageError } from \"./types.js\";\n\nconst TRAILING_SLASH_PATTERN = /\\/$/;\n\n/** Type guard for AWS SDK errors (have a `name` property) */\nfunction hasErrorName(error: unknown): error is Error & { name: string } {\n\treturn error instanceof Error && typeof error.name === \"string\";\n}\n\n/**\n * S3-compatible storage implementation\n */\nexport class S3Storage implements Storage {\n\tprivate client: S3Client;\n\tprivate bucket: string;\n\tprivate publicUrl?: string;\n\tprivate endpoint: string;\n\n\tconstructor(config: S3StorageConfig) {\n\t\tthis.bucket = config.bucket;\n\t\tthis.publicUrl = config.publicUrl;\n\t\tthis.endpoint = config.endpoint;\n\n\t\tthis.client = new S3Client({\n\t\t\tendpoint: config.endpoint,\n\t\t\tregion: config.region || \"auto\",\n\t\t\tcredentials: {\n\t\t\t\taccessKeyId: config.accessKeyId,\n\t\t\t\tsecretAccessKey: config.secretAccessKey,\n\t\t\t},\n\t\t\t// Required for R2 and some S3-compatible services\n\t\t\tforcePathStyle: true,\n\t\t});\n\t}\n\n\tasync upload(options: {\n\t\tkey: string;\n\t\tbody: Buffer | Uint8Array | ReadableStream<Uint8Array>;\n\t\tcontentType: string;\n\t}): Promise<UploadResult> {\n\t\ttry {\n\t\t\t// Convert ReadableStream to Buffer if needed\n\t\t\tlet body: Buffer | Uint8Array;\n\t\t\tif (options.body instanceof ReadableStream) {\n\t\t\t\tconst chunks: Uint8Array[] = [];\n\t\t\t\tconst reader = options.body.getReader();\n\t\t\t\twhile (true) {\n\t\t\t\t\tconst { done, value } = await reader.read();\n\t\t\t\t\tif (done) break;\n\t\t\t\t\tchunks.push(value);\n\t\t\t\t}\n\t\t\t\tbody = Buffer.concat(chunks);\n\t\t\t} else {\n\t\t\t\tbody = options.body;\n\t\t\t}\n\n\t\t\tawait this.client.send(\n\t\t\t\tnew PutObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: options.key,\n\t\t\t\t\tBody: body,\n\t\t\t\t\tContentType: options.contentType,\n\t\t\t\t}),\n\t\t\t);\n\n\t\t\treturn {\n\t\t\t\tkey: options.key,\n\t\t\t\turl: this.getPublicUrl(options.key),\n\t\t\t\tsize: body.length,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tthrow new EmDashStorageError(\n\t\t\t\t`Failed to upload file: ${options.key}`,\n\t\t\t\t\"UPLOAD_FAILED\",\n\t\t\t\terror,\n\t\t\t);\n\t\t}\n\t}\n\n\tasync download(key: string): Promise<DownloadResult> {\n\t\ttry {\n\t\t\tconst response = await this.client.send(\n\t\t\t\tnew GetObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: key,\n\t\t\t\t}),\n\t\t\t);\n\n\t\t\tif (!response.Body) {\n\t\t\t\tthrow new EmDashStorageError(`File not found: ${key}`, \"NOT_FOUND\");\n\t\t\t}\n\n\t\t\t// Convert SDK stream to web ReadableStream\n\t\t\tconst body = response.Body.transformToWebStream();\n\n\t\t\treturn {\n\t\t\t\tbody,\n\t\t\t\tcontentType: response.ContentType || \"application/octet-stream\",\n\t\t\t\tsize: response.ContentLength || 0,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tif (\n\t\t\t\terror instanceof EmDashStorageError ||\n\t\t\t\t(hasErrorName(error) && error.name === \"NoSuchKey\")\n\t\t\t) {\n\t\t\t\tthrow new EmDashStorageError(`File not found: ${key}`, \"NOT_FOUND\", error);\n\t\t\t}\n\t\t\tthrow new EmDashStorageError(`Failed to download file: ${key}`, \"DOWNLOAD_FAILED\", error);\n\t\t}\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\ttry {\n\t\t\tawait this.client.send(\n\t\t\t\tnew DeleteObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: key,\n\t\t\t\t}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\t// S3 delete is idempotent, so we ignore \"not found\" errors\n\t\t\tif (!hasErrorName(error) || error.name !== \"NoSuchKey\") {\n\t\t\t\tthrow new EmDashStorageError(`Failed to delete file: ${key}`, \"DELETE_FAILED\", error);\n\t\t\t}\n\t\t}\n\t}\n\n\tasync exists(key: string): Promise<boolean> {\n\t\ttry {\n\t\t\tawait this.client.send(\n\t\t\t\tnew HeadObjectCommand({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tKey: key,\n\t\t\t\t}),\n\t\t\t);\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tif (hasErrorName(error) && error.name === \"NotFound\") {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tthrow new EmDashStorageError(\n\t\t\t\t`Failed to check file existence: ${key}`,\n\t\t\t\t\"HEAD_FAILED\",\n\t\t\t\terror,\n\t\t\t);\n\t\t}\n\t}\n\n\tasync list(options: ListOptions = {}): Promise<ListResult> {\n\t\ttry {\n\t\t\t// eslint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- S3 client.send returns generic output; narrowing to ListObjectsV2Response\n\t\t\tconst response = (await this.client.send(\n\t\t\t\tnew ListObjectsV2Command({\n\t\t\t\t\tBucket: this.bucket,\n\t\t\t\t\tPrefix: options.prefix,\n\t\t\t\t\tMaxKeys: options.limit,\n\t\t\t\t\tContinuationToken: options.cursor,\n\t\t\t\t}),\n\t\t\t)) as ListObjectsV2Response;\n\n\t\t\treturn {\n\t\t\t\tfiles: (response.Contents || []).map(\n\t\t\t\t\t(item: { Key?: string; Size?: number; LastModified?: Date; ETag?: string }) => ({\n\t\t\t\t\t\tkey: item.Key!,\n\t\t\t\t\t\tsize: item.Size || 0,\n\t\t\t\t\t\tlastModified: item.LastModified || new Date(),\n\t\t\t\t\t\tetag: item.ETag,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t\tnextCursor: response.NextContinuationToken,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tthrow new EmDashStorageError(\"Failed to list files\", \"LIST_FAILED\", error);\n\t\t}\n\t}\n\n\tasync getSignedUploadUrl(options: SignedUploadOptions): Promise<SignedUploadUrl> {\n\t\ttry {\n\t\t\tconst expiresIn = options.expiresIn || 3600; // 1 hour default\n\n\t\t\tconst command = new PutObjectCommand({\n\t\t\t\tBucket: this.bucket,\n\t\t\t\tKey: options.key,\n\t\t\t\tContentType: options.contentType,\n\t\t\t\tContentLength: options.size,\n\t\t\t});\n\n\t\t\tconst url = await getSignedUrl(this.client, command, { expiresIn });\n\n\t\t\tconst expiresAt = new Date(Date.now() + expiresIn * 1000).toISOString();\n\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\tmethod: \"PUT\",\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": options.contentType,\n\t\t\t\t\t...(options.size ? { \"Content-Length\": String(options.size) } : {}),\n\t\t\t\t},\n\t\t\t\texpiresAt,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tthrow new EmDashStorageError(\n\t\t\t\t`Failed to generate signed URL for: ${options.key}`,\n\t\t\t\t\"SIGNED_URL_FAILED\",\n\t\t\t\terror,\n\t\t\t);\n\t\t}\n\t}\n\n\tgetPublicUrl(key: string): string {\n\t\tif (this.publicUrl) {\n\t\t\treturn `${this.publicUrl.replace(TRAILING_SLASH_PATTERN, \"\")}/${key}`;\n\t\t}\n\t\t// Default to endpoint + bucket + key\n\t\treturn `${this.endpoint.replace(TRAILING_SLASH_PATTERN, \"\")}/${this.bucket}/${key}`;\n\t}\n}\n\n/**\n * Create S3 storage adapter\n * This is the factory function called at runtime\n */\nexport function createStorage(config: Record<string, unknown>): Storage {\n\tconst { endpoint, bucket, accessKeyId, secretAccessKey, region, publicUrl } = config;\n\tif (\n\t\ttypeof endpoint !== \"string\" ||\n\t\ttypeof bucket !== \"string\" ||\n\t\ttypeof accessKeyId !== \"string\" ||\n\t\ttypeof secretAccessKey !== \"string\"\n\t) {\n\t\tthrow new Error(\n\t\t\t\"S3Storage requires 'endpoint', 'bucket', 'accessKeyId', and 'secretAccessKey' string config values\",\n\t\t);\n\t}\n\treturn new S3Storage({\n\t\tendpoint,\n\t\tbucket,\n\t\taccessKeyId,\n\t\tsecretAccessKey,\n\t\tregion: typeof region === \"string\" ? region : undefined,\n\t\tpublicUrl: typeof publicUrl === \"string\" ? publicUrl : undefined,\n\t});\n}\n"],"mappings":"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"}