img-upload-kit 0.0.0-stage → 2.0.0

package/dist/storage.cjs

@@ -0,0 +1,447 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+var _chunkYRXXQUDEcjs = require('./chunk-YRXXQUDE.cjs');
+
+
+
+var _chunkQHU7FUO4cjs = require('./chunk-QHU7FUO4.cjs');
+
+// src/storage/localFsAdapter.ts
+var _promises = require('fs/promises'); var _promises2 = _interopRequireDefault(_promises);
+var _path = require('path'); var _path2 = _interopRequireDefault(_path);
+function sanitizeRelativePath(inputPath) {
+  if (!inputPath || typeof inputPath !== "string") {
+    throw new Error("Invalid storage path");
+  }
+  if (inputPath.includes(":") || inputPath.includes("\0")) {
+    throw new Error("Path traversal blocked in LocalFsStorageAdapter");
+  }
+  const normalized = inputPath.replace(/\\/g, "/").replace(/^\/+/, "");
+  const rawSegments = normalized.split("/").filter(Boolean);
+  if (rawSegments.length === 0) {
+    throw new Error("Invalid storage path");
+  }
+  for (const segment of rawSegments) {
+    if (segment === "." || segment === "..") {
+      throw new Error("Invalid storage path: path traversal blocked");
+    }
+  }
+  return rawSegments.join("/");
+}
+function assertContainedInRoot(resolvedRoot, targetPath) {
+  const relative = _path2.default.relative(resolvedRoot, targetPath);
+  if (relative.startsWith("..") || _path2.default.isAbsolute(relative)) {
+    throw new Error("Path traversal blocked in LocalFsStorageAdapter");
+  }
+}
+function createLocalFsStorageAdapter(options) {
+  const resolvedRoot = _path2.default.resolve(options.rootDir);
+  const baseUrl = (_nullishCoalesce(options.baseUrl, () => ( "/uploads"))).replace(/\/+$/, "");
+  const includeBucket = options.includeBucketInPath !== false;
+  const resolveDiskTarget = (bucket, relativePath) => {
+    const cleanBucket = sanitizeRelativePath(bucket);
+    const cleanRel = sanitizeRelativePath(relativePath);
+    const subPath = includeBucket ? `${cleanBucket}/${cleanRel}` : cleanRel;
+    const diskPath = _path2.default.resolve(resolvedRoot, subPath);
+    assertContainedInRoot(resolvedRoot, diskPath);
+    return { diskPath, subPath, cleanRel };
+  };
+  const getPublicUrl = (bucket, relativePath) => {
+    const { subPath } = resolveDiskTarget(bucket, relativePath);
+    return `${baseUrl}/${subPath}`;
+  };
+  const parseUrl = (url) => {
+    if (!url || typeof url !== "string") return null;
+    try {
+      const cleanUrl = url.split(/[?#]/)[0];
+      const prefix = `${baseUrl}/`;
+      let subPath = null;
+      if (cleanUrl.startsWith(prefix)) {
+        subPath = cleanUrl.slice(prefix.length);
+      } else if (baseUrl.startsWith("/")) {
+        const parsed = new URL(cleanUrl, "http://localhost");
+        const isLocal = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+        const isRelative = !cleanUrl.startsWith("http://") && !cleanUrl.startsWith("https://");
+        if ((isLocal || isRelative) && parsed.pathname.startsWith(prefix)) {
+          subPath = parsed.pathname.slice(prefix.length);
+        }
+      }
+      if (!subPath) return null;
+      const decoded = decodeURIComponent(subPath).replace(/\\/g, "/").replace(/^\/+/, "");
+      if (!decoded || decoded.includes(":") || decoded.includes("\0")) {
+        return null;
+      }
+      const segments = decoded.split("/").filter(Boolean);
+      if (segments.length === 0 || segments.includes("..") || segments.includes(".")) {
+        return null;
+      }
+      const diskPath = _path2.default.resolve(resolvedRoot, ...segments);
+      const relative = _path2.default.relative(resolvedRoot, diskPath);
+      if (relative.startsWith("..") || _path2.default.isAbsolute(relative)) {
+        return null;
+      }
+      if (includeBucket) {
+        if (segments.length < 2) return null;
+        return {
+          bucket: segments[0],
+          path: segments.slice(1).join("/")
+        };
+      }
+      return { path: segments.join("/") };
+    } catch (e2) {
+      return null;
+    }
+  };
+  return {
+    async upload(params) {
+      const { diskPath, cleanRel } = resolveDiskTarget(
+        params.bucket,
+        params.path
+      );
+      await _promises2.default.mkdir(_path2.default.dirname(diskPath), { recursive: true });
+      try {
+        await _promises2.default.writeFile(
+          diskPath,
+          params.data,
+          params.upsert === false ? { flag: "wx" } : void 0
+        );
+      } catch (err) {
+        if (err.code === "EEXIST") {
+          const existsError = new Error(
+            `File already exists at ${params.bucket}/${cleanRel}`
+          );
+          existsError.code = "EEXIST";
+          throw existsError;
+        }
+        throw err;
+      }
+      return {
+        bucket: params.bucket,
+        path: cleanRel,
+        url: getPublicUrl(params.bucket, cleanRel)
+      };
+    },
+    async delete(bucket, relativePath) {
+      const { diskPath } = resolveDiskTarget(bucket, relativePath);
+      try {
+        await _promises2.default.unlink(diskPath);
+      } catch (err) {
+        if (err.code !== "ENOENT") {
+          throw err;
+        }
+      }
+    },
+    async exists(bucket, relativePath) {
+      try {
+        const { diskPath } = resolveDiskTarget(bucket, relativePath);
+        const stat = await _promises2.default.stat(diskPath);
+        return stat.isFile();
+      } catch (e3) {
+        return false;
+      }
+    },
+    getPublicUrl,
+    parseUrl,
+    async deleteByUrl(url) {
+      const parsed = parseUrl(url);
+      if (!parsed) return false;
+      try {
+        const subSegments = includeBucket && parsed.bucket ? [parsed.bucket, ...parsed.path.split("/")] : parsed.path.split("/");
+        const diskPath = _path2.default.resolve(resolvedRoot, ...subSegments);
+        assertContainedInRoot(resolvedRoot, diskPath);
+        await _promises2.default.unlink(diskPath);
+        return true;
+      } catch (e4) {
+        return false;
+      }
+    },
+    async list(bucket, folder, listOptions) {
+      const cleanBucket = sanitizeRelativePath(bucket);
+      const cleanFolder = folder ? sanitizeRelativePath(folder) : "";
+      const targetDir = _path2.default.resolve(
+        resolvedRoot,
+        includeBucket ? cleanBucket : "",
+        cleanFolder
+      );
+      assertContainedInRoot(resolvedRoot, targetDir);
+      try {
+        const dirEntries = await _promises2.default.readdir(targetDir, { withFileTypes: true });
+        const results = [];
+        for (const entry of dirEntries) {
+          if (!entry.isFile()) continue;
+          const full = _path2.default.join(targetDir, entry.name);
+          const stat = await _promises2.default.stat(full);
+          results.push({
+            name: entry.name,
+            id: entry.name,
+            createdAt: stat.birthtime.toISOString(),
+            size: stat.size
+          });
+        }
+        const offset = _optionalChain([listOptions, 'optionalAccess', _ => _.cursor]) ? Number(listOptions.cursor) || 0 : 0;
+        const limit = _nullishCoalesce(_optionalChain([listOptions, 'optionalAccess', _2 => _2.limit]), () => ( results.length));
+        const sliced = _optionalChain([listOptions, 'optionalAccess', _3 => _3.limit]) !== void 0 || offset > 0 ? results.slice(offset, offset + limit) : results;
+        const nextCursor = _optionalChain([listOptions, 'optionalAccess', _4 => _4.limit]) !== void 0 && offset + sliced.length < results.length ? String(offset + sliced.length) : void 0;
+        return _chunkYRXXQUDEcjs.toPaginatedListResult.call(void 0, sliced, nextCursor);
+      } catch (err) {
+        if (err.code === "ENOENT") {
+          return _chunkYRXXQUDEcjs.toPaginatedListResult.call(void 0, []);
+        }
+        throw err;
+      }
+    }
+  };
+}
+
+// src/storage/s3Adapter.ts
+function normalizeS3Key(rawPath) {
+  const normalized = rawPath.replace(/\\/g, "/").replace(/^\/+/, "");
+  if (!normalized) throw new Error("Invalid S3 object key");
+  return normalized;
+}
+function resolveTransport(options) {
+  if ("client" in options && options.client) return options.client;
+  if ("transport" in options && options.transport) return options.transport;
+  if ("putObject" in options && typeof options.putObject === "function") return options;
+  throw new Error("S3StorageAdapter requires putObject/deleteObject or client/transport");
+}
+function isS3PreconditionError(err) {
+  if (!err || typeof err !== "object") return false;
+  const e = err;
+  const status = _nullishCoalesce(_optionalChain([e, 'access', _5 => _5.$metadata, 'optionalAccess', _6 => _6.httpStatusCode]), () => ( Number(e.statusCode)));
+  const code = String(_nullishCoalesce(_nullishCoalesce(e.code, () => ( e.name)), () => ( ""))).toLowerCase();
+  return status === 412 || code === "preconditionfailed" || code === "eexist";
+}
+function createS3StorageAdapter(options) {
+  const transport = resolveTransport(options);
+  const includeBucket = options.includeBucketInUrl !== false;
+  const getPublicUrl = (bucket, path2) => {
+    const key = normalizeS3Key(path2);
+    if (typeof options.publicBaseUrl === "function") return options.publicBaseUrl(bucket, key);
+    const base = options.publicBaseUrl.replace(/\/+$/, "");
+    return includeBucket ? `${base}/${bucket}/${key}` : `${base}/${key}`;
+  };
+  return {
+    async upload(params) {
+      const key = normalizeS3Key(params.path);
+      _chunkYRXXQUDEcjs.validateStorageMetadata.call(void 0, params.metadata);
+      const isImmutable = params.upsert === false && params.contentType.includes("image/avif");
+      const cacheControl = _nullishCoalesce(_nullishCoalesce(params.cacheControl, () => ( options.cacheControl)), () => ( (isImmutable ? "public, max-age=31536000, immutable" : "public, max-age=2592000, must-revalidate")));
+      const metadata = params.metadata || params.contentHash ? {
+        ...params.metadata,
+        ...params.contentHash ? { contentHash: params.contentHash } : {}
+      } : void 0;
+      try {
+        await transport.putObject({
+          Bucket: params.bucket,
+          Key: key,
+          Body: params.data,
+          ContentType: params.contentType,
+          ...cacheControl ? { CacheControl: cacheControl } : {},
+          ...metadata ? { Metadata: metadata } : {},
+          ...params.upsert === false ? { IfNoneMatch: "*" } : {}
+        });
+      } catch (err) {
+        if (isS3PreconditionError(err)) {
+          const existsErr = new Error(
+            `Object already exists at ${params.bucket}/${key}`
+          );
+          existsErr.code = "EEXIST";
+          existsErr.statusCode = 412;
+          throw existsErr;
+        }
+        throw err;
+      }
+      return {
+        bucket: params.bucket,
+        path: key,
+        url: getPublicUrl(params.bucket, key)
+      };
+    },
+    async delete(bucket, path2) {
+      await transport.deleteObject({ Bucket: bucket, Key: normalizeS3Key(path2) });
+    },
+    async exists(bucket, path2) {
+      const key = normalizeS3Key(path2);
+      if (transport.headObject) {
+        try {
+          await transport.headObject({ Bucket: bucket, Key: key });
+          return true;
+        } catch (e5) {
+          return false;
+        }
+      }
+      const lastSlash = key.lastIndexOf("/");
+      const folder = lastSlash > 0 ? key.slice(0, lastSlash) : void 0;
+      const targetName = lastSlash > 0 ? key.slice(lastSlash + 1) : key;
+      const listed = await this.list(bucket, folder);
+      return listed.some((item) => item.name === targetName);
+    },
+    getPublicUrl,
+    async list(bucket, folder, listOptions) {
+      const cleanFolder = folder ? normalizeS3Key(folder).replace(/\/+$/, "") : "";
+      const prefix = cleanFolder ? `${cleanFolder}/` : void 0;
+      const input = {
+        Bucket: bucket,
+        ...prefix ? { Prefix: prefix } : {},
+        MaxKeys: _nullishCoalesce(_optionalChain([listOptions, 'optionalAccess', _7 => _7.limit]), () => ( 1e3)),
+        ..._optionalChain([listOptions, 'optionalAccess', _8 => _8.cursor]) ? { ContinuationToken: listOptions.cursor } : {}
+      };
+      const output = transport.listObjects ? await transport.listObjects(input) : transport.listObjectsV2 ? await transport.listObjectsV2(input) : void 0;
+      const entries = (_nullishCoalesce(_optionalChain([output, 'optionalAccess', _9 => _9.Contents]), () => ( []))).filter((item) => Boolean(item.Key)).map((item) => {
+        const name = prefix && item.Key.startsWith(prefix) ? item.Key.slice(prefix.length) : item.Key;
+        const createdAt = item.LastModified instanceof Date ? item.LastModified.toISOString() : item.LastModified;
+        return {
+          name,
+          id: `${bucket}/${item.Key}`,
+          ...createdAt !== void 0 ? { createdAt } : {},
+          ...item.Size !== void 0 ? { size: item.Size } : {}
+        };
+      }).filter((entry) => entry.name.length > 0);
+      return _chunkYRXXQUDEcjs.toPaginatedListResult.call(void 0, entries, _optionalChain([output, 'optionalAccess', _10 => _10.NextContinuationToken]));
+    },
+    parseUrl(url) {
+      if (typeof options.publicBaseUrl !== "string" || !url) return null;
+      const prefix = `${options.publicBaseUrl.replace(/\/+$/, "")}/`;
+      const cleanUrl = url.split(/[?#]/)[0];
+      if (!cleanUrl.startsWith(prefix)) return null;
+      try {
+        const rest = decodeURIComponent(cleanUrl.slice(prefix.length)).replace(/^\/+/, "");
+        if (!rest) return null;
+        if (includeBucket) {
+          const slashIdx = rest.indexOf("/");
+          if (slashIdx <= 0 || slashIdx === rest.length - 1) return null;
+          return {
+            bucket: rest.slice(0, slashIdx),
+            path: rest.slice(slashIdx + 1)
+          };
+        }
+        if (!options.defaultBucket) return null;
+        return { bucket: options.defaultBucket, path: rest };
+      } catch (e6) {
+        return null;
+      }
+    },
+    async deleteByUrl(url) {
+      const parsed = _optionalChain([this, 'access', _11 => _11.parseUrl, 'optionalCall', _12 => _12(url)]);
+      if (!parsed || !parsed.bucket) return false;
+      try {
+        await transport.deleteObject({
+          Bucket: parsed.bucket,
+          Key: parsed.path
+        });
+        return true;
+      } catch (e7) {
+        return false;
+      }
+    }
+  };
+}
+
+// src/storage/supabaseAdapter.ts
+function createSupabaseStorageAdapter(client, options = {}) {
+  const publicPrefix = options.publicUrlPrefix || _chunkQHU7FUO4cjs.DEFAULT_PUBLIC_STORAGE_PREFIX;
+  return {
+    async upload(params) {
+      _chunkYRXXQUDEcjs.validateStorageMetadata.call(void 0, params.metadata);
+      const isImmutable = params.upsert === false && params.contentType.includes("image/avif");
+      const cacheControl = params.cacheControl || (isImmutable ? "public, max-age=31536000, immutable" : "public, max-age=2592000, must-revalidate");
+      const { data, error } = await client.storage.from(params.bucket).upload(params.path, params.data, {
+        contentType: params.contentType,
+        upsert: params.upsert === void 0 ? true : params.upsert,
+        cacheControl,
+        metadata: {
+          ...params.metadata,
+          uploadedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          contentHash: params.contentHash || "unknown"
+        }
+      });
+      if (error || !data) {
+        throw new Error(
+          `Failed to upload to Supabase storage (bucket: ${params.bucket}, path: ${params.path}): ${_optionalChain([error, 'optionalAccess', _13 => _13.message]) || "Unknown error"}`
+        );
+      }
+      const {
+        data: { publicUrl }
+      } = client.storage.from(params.bucket).getPublicUrl(data.path);
+      return {
+        bucket: params.bucket,
+        path: data.path,
+        url: publicUrl
+      };
+    },
+    async delete(bucket, path2) {
+      const { error } = await client.storage.from(bucket).remove([path2]);
+      if (error) {
+        throw new Error(`Failed to delete from Supabase storage: ${error.message}`);
+      }
+    },
+    async exists(bucket, path2) {
+      const cleanPath = path2.replace(/^\/+/, "");
+      const lastSlash = cleanPath.lastIndexOf("/");
+      const folder = lastSlash > 0 ? cleanPath.slice(0, lastSlash) : void 0;
+      const targetName = lastSlash > 0 ? cleanPath.slice(lastSlash + 1) : cleanPath;
+      const entries = await this.list(bucket, folder);
+      return entries.some((entry) => entry.name === targetName);
+    },
+    getPublicUrl(bucket, path2) {
+      const {
+        data: { publicUrl }
+      } = client.storage.from(bucket).getPublicUrl(path2);
+      return publicUrl;
+    },
+    async list(bucket, folder, listOptions) {
+      const bucketClient = client.storage.from(bucket);
+      if (!bucketClient.list) {
+        return _chunkYRXXQUDEcjs.toPaginatedListResult.call(void 0, []);
+      }
+      const limit = _nullishCoalesce(_optionalChain([listOptions, 'optionalAccess', _14 => _14.limit]), () => ( 1e3));
+      const offset = _optionalChain([listOptions, 'optionalAccess', _15 => _15.cursor]) ? Number(listOptions.cursor) || 0 : 0;
+      const { data, error } = await bucketClient.list(folder, {
+        limit,
+        ...offset > 0 ? { offset } : {},
+        sortBy: { column: "created_at", order: "desc" }
+      });
+      if (error) {
+        throw new Error(`Failed to list Supabase bucket files: ${error.message}`);
+      }
+      const entries = (data || []).filter((f) => f.id !== null).map((f) => ({
+        name: f.name,
+        id: _nullishCoalesce(f.id, () => ( void 0)),
+        createdAt: _nullishCoalesce(f.created_at, () => ( void 0))
+      }));
+      const nextCursor = _optionalChain([listOptions, 'optionalAccess', _16 => _16.limit]) !== void 0 && entries.length >= limit ? String(offset + entries.length) : void 0;
+      return _chunkYRXXQUDEcjs.toPaginatedListResult.call(void 0, entries, nextCursor);
+    },
+    parseUrl(url) {
+      const info = _chunkQHU7FUO4cjs.parsePublicStorageUrl.call(void 0, url, publicPrefix);
+      if (!info) return null;
+      return { bucket: info.bucket, path: info.path };
+    },
+    async deleteByUrl(url) {
+      const info = _chunkQHU7FUO4cjs.parsePublicStorageUrl.call(void 0, url, publicPrefix);
+      if (!info) return false;
+      try {
+        const { error } = await client.storage.from(info.bucket).remove([info.path]);
+        return !error;
+      } catch (e8) {
+        return false;
+      }
+    }
+  };
+}
+
+
+
+
+
+
+
+
+
+
+exports.DEFAULT_PUBLIC_STORAGE_PREFIX = _chunkQHU7FUO4cjs.DEFAULT_PUBLIC_STORAGE_PREFIX; exports.createLocalFsStorageAdapter = createLocalFsStorageAdapter; exports.createMemoryStorageAdapter = _chunkYRXXQUDEcjs.createMemoryStorageAdapter; exports.createS3StorageAdapter = createS3StorageAdapter; exports.createStorageAdapter = _chunkYRXXQUDEcjs.createStorageAdapter; exports.createSupabaseStorageAdapter = createSupabaseStorageAdapter; exports.parsePublicStorageUrl = _chunkQHU7FUO4cjs.parsePublicStorageUrl; exports.toPaginatedListResult = _chunkYRXXQUDEcjs.toPaginatedListResult; exports.validateStorageMetadata = _chunkYRXXQUDEcjs.validateStorageMetadata;
+//# sourceMappingURL=storage.cjs.map

package/dist/storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/image-upload-kit/image-upload-kit/dist/storage.cjs","../src/storage/localFsAdapter.ts","../src/storage/s3Adapter.ts","../src/storage/supabaseAdapter.ts"],"names":["path"],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACA;ACXA,2FAAe;AACf,wEAAiB;AAoBjB,SAAS,oBAAA,CAAqB,SAAA,EAA2B;AACvD,EAAA,GAAA,CAAI,CAAC,UAAA,GAAa,OAAO,UAAA,IAAc,QAAA,EAAU;AAC/C,IAAA,MAAM,IAAI,KAAA,CAAM,sBAAsB,CAAA;AAAA,EACxC;AACA,EAAA,GAAA,CAAI,SAAA,CAAU,QAAA,CAAS,GAAG,EAAA,GAAK,SAAA,CAAU,QAAA,CAAS,IAAI,CAAA,EAAG;AACvD,IAAA,MAAM,IAAI,KAAA,CAAM,iDAAiD,CAAA;AAAA,EACnE;AAEA,EAAA,MAAM,WAAA,EAAa,SAAA,CAAU,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA,CAAE,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AACnE,EAAA,MAAM,YAAA,EAAc,UAAA,CAAW,KAAA,CAAM,GAAG,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA;AAExD,EAAA,GAAA,CAAI,WAAA,CAAY,OAAA,IAAW,CAAA,EAAG;AAC5B,IAAA,MAAM,IAAI,KAAA,CAAM,sBAAsB,CAAA;AAAA,EACxC;AAEA,EAAA,IAAA,CAAA,MAAW,QAAA,GAAW,WAAA,EAAa;AACjC,IAAA,GAAA,CAAI,QAAA,IAAY,IAAA,GAAO,QAAA,IAAY,IAAA,EAAM;AACvC,MAAA,MAAM,IAAI,KAAA,CAAM,8CAA8C,CAAA;AAAA,IAChE;AAAA,EACF;AAEA,EAAA,OAAO,WAAA,CAAY,IAAA,CAAK,GAAG,CAAA;AAC7B;AAEA,SAAS,qBAAA,CAAsB,YAAA,EAAsB,UAAA,EAA0B;AAC7E,EAAA,MAAM,SAAA,EAAW,cAAA,CAAK,QAAA,CAAS,YAAA,EAAc,UAAU,CAAA;AACvD,EAAA,GAAA,CAAI,QAAA,CAAS,UAAA,CAAW,IAAI,EAAA,GAAK,cAAA,CAAK,UAAA,CAAW,QAAQ,CAAA,EAAG;AAC1D,IAAA,MAAM,IAAI,KAAA,CAAM,iDAAiD,CAAA;AAAA,EACnE;AACF;AAcO,SAAS,2BAAA,CACd,OAAA,EACuB;AACvB,EAAA,MAAM,aAAA,EAAe,cAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,OAAO,CAAA;AACjD,EAAA,MAAM,QAAA,EAAA,kBAAW,OAAA,CAAQ,OAAA,UAAW,YAAA,CAAA,CAAY,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AAClE,EAAA,MAAM,cAAA,EAAgB,OAAA,CAAQ,oBAAA,IAAwB,KAAA;AAEtD,EAAA,MAAM,kBAAA,EAAoB,CAAC,MAAA,EAAgB,YAAA,EAAA,GAAyB;AAClE,IAAA,MAAM,YAAA,EAAc,oBAAA,CAAqB,MAAM,CAAA;AAC/C,IAAA,MAAM,SAAA,EAAW,oBAAA,CAAqB,YAAY,CAAA;AAClD,IAAA,MAAM,QAAA,EAAU,cAAA,EAAgB,CAAA,EAAA;AACF,IAAA;AAER,IAAA;AAEM,IAAA;AAC9B,EAAA;AAEsC,EAAA;AAChB,IAAA;AACQ,IAAA;AAC9B,EAAA;AAE4E,EAAA;AAC/C,IAAA;AAEvB,IAAA;AACyB,MAAA;AACF,MAAA;AACI,MAAA;AAEC,MAAA;AACH,QAAA;AACG,MAAA;AACL,QAAA;AAEd,QAAA;AAEG,QAAA;AACI,QAAA;AACY,UAAA;AAC5B,QAAA;AACF,MAAA;AAEqB,MAAA;AAEL,MAAA;AAGQ,MAAA;AACf,QAAA;AACT,MAAA;AAE+B,MAAA;AAG7B,MAAA;AAGO,QAAA;AACT,MAAA;AAE8B,MAAA;AACC,MAAA;AACH,MAAA;AACnB,QAAA;AACT,MAAA;AAEmB,MAAA;AACQ,QAAA;AAClB,QAAA;AACa,UAAA;AACM,UAAA;AAC1B,QAAA;AACF,MAAA;AAE6B,MAAA;AACvB,IAAA;AACC,MAAA;AACT,IAAA;AACF,EAAA;AAEO,EAAA;AACmE,IAAA;AACvC,MAAA;AACtB,QAAA;AACA,QAAA;AACT,MAAA;AAE4B,MAAA;AAExB,MAAA;AACO,QAAA;AACP,UAAA;AACO,UAAA;AACmB,UAAA;AAC5B,QAAA;AACY,MAAA;AAC0C,QAAA;AAC5B,UAAA;AACtB,YAAA;AACF,UAAA;AACmB,UAAA;AACb,UAAA;AACR,QAAA;AACM,QAAA;AACR,MAAA;AAEO,MAAA;AACU,QAAA;AACT,QAAA;AACmB,QAAA;AAC3B,MAAA;AACF,IAAA;AAE6B,IAAA;AACN,MAAA;AACjB,MAAA;AACsB,QAAA;AACZ,MAAA;AAC0C,QAAA;AAC9C,UAAA;AACR,QAAA;AACF,MAAA;AACF,IAAA;AAE6B,IAAA;AACvB,MAAA;AACmB,QAAA;AACM,QAAA;AACR,QAAA;AACb,MAAA;AACC,QAAA;AACT,MAAA;AACF,IAAA;AAEA,IAAA;AACA,IAAA;AAEiD,IAAA;AACpB,MAAA;AACP,MAAA;AAEhB,MAAA;AAEA,QAAA;AAGoB,QAAA;AACA,QAAA;AACE,QAAA;AACjB,QAAA;AACD,MAAA;AACC,QAAA;AACT,MAAA;AACF,IAAA;AAKE,IAAA;AAEoB,MAAA;AACS,MAAA;AACN,MAAA;AACrB,QAAA;AACgB,QAAA;AAChB,QAAA;AACF,MAAA;AAEsB,MAAA;AAElB,MAAA;AAC0B,QAAA;AACS,QAAA;AAEjB,QAAA;AACG,UAAA;AACE,UAAA;AACI,UAAA;AACd,UAAA;AACC,YAAA;AACF,YAAA;AACM,YAAA;AACL,YAAA;AACZ,UAAA;AACH,QAAA;AAE4B,QAAA;AACD,QAAA;AAEZ,QAAA;AAIb,QAAA;AAI2B,QAAA;AACjB,MAAA;AAC0C,QAAA;AAC7C,UAAA;AACT,QAAA;AACM,QAAA;AACR,MAAA;AACF,IAAA;AACF,EAAA;AACF;AD3EqC;AACA;AEvHY;AACZ,EAAA;AACF,EAAA;AAC1B,EAAA;AACT;AAE6E;AACxC,EAAA;AACL,EAAA;AACA,EAAA;AACd,EAAA;AAClB;AAEsD;AACzB,EAAA;AACjB,EAAA;AAMkB,EAAA;AACI,EAAA;AACE,EAAA;AACpC;AAGuC;AACF,EAAA;AACL,EAAA;AAEQA,EAAAA;AACL,IAAA;AACZ,IAAA;AACE,IAAA;AACS,IAAA;AAChC,EAAA;AAEO,EAAA;AACmE,IAAA;AAC3C,MAAA;AACI,MAAA;AAGtB,MAAA;AAEA,MAAA;AAOA,MAAA;AAES,QAAA;AACiB,QAAA;AAE7B,MAAA;AAEF,MAAA;AACwB,QAAA;AACT,UAAA;AACV,UAAA;AACQ,UAAA;AACO,UAAA;AACC,UAAA;AACM,UAAA;AACL,UAAA;AACvB,QAAA;AACW,MAAA;AACiB,QAAA;AACL,UAAA;AACpB,YAAA;AACF,UAAA;AACiB,UAAA;AACM,UAAA;AACjB,UAAA;AACR,QAAA;AACM,QAAA;AACR,MAAA;AAEO,MAAA;AACU,QAAA;AACT,QAAA;AACmB,QAAA;AAC3B,MAAA;AACF,IAAA;AAE0D,IAAA;AACzB,MAAA;AACjC,IAAA;AAE6D,IAAA;AAChCA,MAAAA;AACD,MAAA;AACpB,QAAA;AACyB,UAAA;AACpB,UAAA;AACD,QAAA;AACC,UAAA;AACT,QAAA;AACF,MAAA;AACsB,MAAA;AACS,MAAA;AACA,MAAA;AACC,MAAA;AACH,MAAA;AAC/B,IAAA;AAEA,IAAA;AAKE,IAAA;AAE6B,MAAA;AACA,MAAA;AACK,MAAA;AACxB,QAAA;AACsB,QAAA;AACR,QAAA;AACM,QAAA;AAC9B,MAAA;AAEyB,MAAA;AAMoB,MAAA;AAIxB,QAAA;AAIV,QAAA;AAGA,QAAA;AACL,UAAA;AACyB,UAAA;AACK,UAAA;AACA,UAAA;AAChC,QAAA;AAEuB,MAAA;AAEE,MAAA;AAC/B,IAAA;AAEgE,IAAA;AAC3C,MAAA;AACO,MAAA;AACC,MAAA;AACI,MAAA;AAE3B,MAAA;AACW,QAAA;AACK,QAAA;AAEC,QAAA;AACK,UAAA;AACD,UAAA;AACd,UAAA;AACiB,YAAA;AACL,YAAA;AACnB,UAAA;AACF,QAAA;AAE4B,QAAA;AACH,QAAA;AACnB,MAAA;AACC,QAAA;AACT,MAAA;AACF,IAAA;AAEiD,IAAA;AAChB,MAAA;AACA,MAAA;AAE3B,MAAA;AAC2B,QAAA;AACZ,UAAA;AACH,UAAA;AACb,QAAA;AACM,QAAA;AACD,MAAA;AACC,QAAA;AACT,MAAA;AACF,IAAA;AACF,EAAA;AACF;AFmEqC;AACA;AGjRrB;AAKJ,EAAA;AAEH,EAAA;AACmE,IAAA;AACvC,MAAA;AAGtB,MAAA;AAEA,MAAA;AAKqB,MAAA;AAGN,QAAA;AACM,QAAA;AAC1B,QAAA;AACU,QAAA;AACE,UAAA;AACE,UAAA;AACQ,UAAA;AACtB,QAAA;AACD,MAAA;AAEiB,MAAA;AACR,QAAA;AACR,UAAA;AACF,QAAA;AACF,MAAA;AAEM,MAAA;AACc,QAAA;AACW,MAAA;AAExB,MAAA;AACU,QAAA;AACJ,QAAA;AACN,QAAA;AACP,MAAA;AACF,IAAA;AAE0D,IAAA;AACzB,MAAA;AACpB,MAAA;AACO,QAAA;AAClB,MAAA;AACF,IAAA;AAE6D,IAAA;AACpC,MAAA;AACK,MAAA;AACG,MAAA;AACA,MAAA;AACJ,MAAA;AACI,MAAA;AACjC,IAAA;AAEmD,IAAA;AAC3C,MAAA;AACc,QAAA;AACU,MAAA;AACvB,MAAA;AACT,IAAA;AAKE,IAAA;AAE4B,MAAA;AACJ,MAAA;AACO,QAAA;AAC/B,MAAA;AAE2B,MAAA;AACC,MAAA;AAEE,MAAA;AAC5B,QAAA;AAC8B,QAAA;AACZ,QAAA;AACnB,MAAA;AAEU,MAAA;AACO,QAAA;AAClB,MAAA;AAGG,MAAA;AAES,QAAA;AACI,QAAA;AACe,QAAA;AAC3B,MAAA;AAGF,MAAA;AAI2B,MAAA;AAC/B,IAAA;AAEgE,IAAA;AACjD,MAAA;AACK,MAAA;AACY,MAAA;AAChC,IAAA;AAEiD,IAAA;AAClC,MAAA;AACK,MAAA;AAEd,MAAA;AACsB,QAAA;AAGhB,QAAA;AACF,MAAA;AACC,QAAA;AACT,MAAA;AACF,IAAA;AACF,EAAA;AACF;AH0OqC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/image-upload-kit/image-upload-kit/dist/storage.cjs","sourcesContent":[null,"import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport {\n  type StorageAdapter,\n  type StorageFileEntry,\n  type StorageListOptions,\n  type StoragePaginatedListResult,\n  type StorageUploadParams,\n  type StorageUploadResult,\n  toPaginatedListResult,\n} from './types';\n\nexport interface LocalFsStorageOptions {\n  /** Absolute or relative root directory on disk (e.g. `./public/uploads`) */\n  rootDir: string;\n  /** Public URL prefix matching `rootDir` (e.g. `/uploads` or `https://cdn.example.com/uploads`) */\n  baseUrl?: string;\n  /** Include the bucket segment as a subdirectory under `rootDir`. Defaults to `true`. */\n  includeBucketInPath?: boolean;\n}\n\nfunction sanitizeRelativePath(inputPath: string): string {\n  if (!inputPath || typeof inputPath !== 'string') {\n    throw new Error('Invalid storage path');\n  }\n  if (inputPath.includes(':') || inputPath.includes('\\0')) {\n    throw new Error('Path traversal blocked in LocalFsStorageAdapter');\n  }\n\n  const normalized = inputPath.replace(/\\\\/g, '/').replace(/^\\/+/, '');\n  const rawSegments = normalized.split('/').filter(Boolean);\n\n  if (rawSegments.length === 0) {\n    throw new Error('Invalid storage path');\n  }\n\n  for (const segment of rawSegments) {\n    if (segment === '.' || segment === '..') {\n      throw new Error('Invalid storage path: path traversal blocked');\n    }\n  }\n\n  return rawSegments.join('/');\n}\n\nfunction assertContainedInRoot(resolvedRoot: string, targetPath: string): void {\n  const relative = path.relative(resolvedRoot, targetPath);\n  if (relative.startsWith('..') || path.isAbsolute(relative)) {\n    throw new Error('Path traversal blocked in LocalFsStorageAdapter');\n  }\n}\n\nexport interface LocalFsStorageAdapter extends StorageAdapter {\n  exists(bucket: string, relativePath: string): Promise<boolean>;\n  getPublicUrl(bucket: string, relativePath: string): string;\n  list(\n    bucket: string,\n    folder?: string,\n    options?: StorageListOptions,\n  ): Promise<StoragePaginatedListResult>;\n  deleteByUrl(url: string): Promise<boolean>;\n  parseUrl(url: string): { bucket?: string; path: string } | null;\n}\n\nexport function createLocalFsStorageAdapter(\n  options: LocalFsStorageOptions,\n): LocalFsStorageAdapter {\n  const resolvedRoot = path.resolve(options.rootDir);\n  const baseUrl = (options.baseUrl ?? '/uploads').replace(/\\/+$/, '');\n  const includeBucket = options.includeBucketInPath !== false;\n\n  const resolveDiskTarget = (bucket: string, relativePath: string) => {\n    const cleanBucket = sanitizeRelativePath(bucket);\n    const cleanRel = sanitizeRelativePath(relativePath);\n    const subPath = includeBucket ? `${cleanBucket}/${cleanRel}` : cleanRel;\n    const diskPath = path.resolve(resolvedRoot, subPath);\n\n    assertContainedInRoot(resolvedRoot, diskPath);\n\n    return { diskPath, subPath, cleanRel };\n  };\n\n  const getPublicUrl = (bucket: string, relativePath: string): string => {\n    const { subPath } = resolveDiskTarget(bucket, relativePath);\n    return `${baseUrl}/${subPath}`;\n  };\n\n  const parseUrl = (url: string): { bucket?: string; path: string } | null => {\n    if (!url || typeof url !== 'string') return null;\n\n    try {\n      const cleanUrl = url.split(/[?#]/)[0];\n      const prefix = `${baseUrl}/`;\n      let subPath: string | null = null;\n\n      if (cleanUrl.startsWith(prefix)) {\n        subPath = cleanUrl.slice(prefix.length);\n      } else if (baseUrl.startsWith('/')) {\n        const parsed = new URL(cleanUrl, 'http://localhost');\n        const isLocal =\n          parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1';\n        const isRelative =\n          !cleanUrl.startsWith('http://') && !cleanUrl.startsWith('https://');\n        if ((isLocal || isRelative) && parsed.pathname.startsWith(prefix)) {\n          subPath = parsed.pathname.slice(prefix.length);\n        }\n      }\n\n      if (!subPath) return null;\n\n      const decoded = decodeURIComponent(subPath)\n        .replace(/\\\\/g, '/')\n        .replace(/^\\/+/, '');\n      if (!decoded || decoded.includes(':') || decoded.includes('\\0')) {\n        return null;\n      }\n\n      const segments = decoded.split('/').filter(Boolean);\n      if (\n        segments.length === 0 ||\n        segments.includes('..') ||\n        segments.includes('.')\n      ) {\n        return null;\n      }\n\n      const diskPath = path.resolve(resolvedRoot, ...segments);\n      const relative = path.relative(resolvedRoot, diskPath);\n      if (relative.startsWith('..') || path.isAbsolute(relative)) {\n        return null;\n      }\n\n      if (includeBucket) {\n        if (segments.length < 2) return null;\n        return {\n          bucket: segments[0],\n          path: segments.slice(1).join('/'),\n        };\n      }\n\n      return { path: segments.join('/') };\n    } catch {\n      return null;\n    }\n  };\n\n  return {\n    async upload(params: StorageUploadParams): Promise<StorageUploadResult> {\n      const { diskPath, cleanRel } = resolveDiskTarget(\n        params.bucket,\n        params.path,\n      );\n\n      await fs.mkdir(path.dirname(diskPath), { recursive: true });\n\n      try {\n        await fs.writeFile(\n          diskPath,\n          params.data,\n          params.upsert === false ? { flag: 'wx' } : undefined,\n        );\n      } catch (err) {\n        if ((err as NodeJS.ErrnoException).code === 'EEXIST') {\n          const existsError = new Error(\n            `File already exists at ${params.bucket}/${cleanRel}`,\n          ) as NodeJS.ErrnoException;\n          existsError.code = 'EEXIST';\n          throw existsError;\n        }\n        throw err;\n      }\n\n      return {\n        bucket: params.bucket,\n        path: cleanRel,\n        url: getPublicUrl(params.bucket, cleanRel),\n      };\n    },\n\n    async delete(bucket: string, relativePath: string): Promise<void> {\n      const { diskPath } = resolveDiskTarget(bucket, relativePath);\n      try {\n        await fs.unlink(diskPath);\n      } catch (err) {\n        if ((err as NodeJS.ErrnoException).code !== 'ENOENT') {\n          throw err;\n        }\n      }\n    },\n\n    async exists(bucket: string, relativePath: string): Promise<boolean> {\n      try {\n        const { diskPath } = resolveDiskTarget(bucket, relativePath);\n        const stat = await fs.stat(diskPath);\n        return stat.isFile();\n      } catch {\n        return false;\n      }\n    },\n\n    getPublicUrl,\n    parseUrl,\n\n    async deleteByUrl(url: string): Promise<boolean> {\n      const parsed = parseUrl(url);\n      if (!parsed) return false;\n\n      try {\n        const subSegments =\n          includeBucket && parsed.bucket\n            ? [parsed.bucket, ...parsed.path.split('/')]\n            : parsed.path.split('/');\n        const diskPath = path.resolve(resolvedRoot, ...subSegments);\n        assertContainedInRoot(resolvedRoot, diskPath);\n        await fs.unlink(diskPath);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async list(\n      bucket: string,\n      folder?: string,\n      listOptions?: StorageListOptions,\n    ): Promise<StoragePaginatedListResult> {\n      const cleanBucket = sanitizeRelativePath(bucket);\n      const cleanFolder = folder ? sanitizeRelativePath(folder) : '';\n      const targetDir = path.resolve(\n        resolvedRoot,\n        includeBucket ? cleanBucket : '',\n        cleanFolder,\n      );\n\n      assertContainedInRoot(resolvedRoot, targetDir);\n\n      try {\n        const dirEntries = await fs.readdir(targetDir, { withFileTypes: true });\n        const results: StorageFileEntry[] = [];\n\n        for (const entry of dirEntries) {\n          if (!entry.isFile()) continue;\n          const full = path.join(targetDir, entry.name);\n          const stat = await fs.stat(full);\n          results.push({\n            name: entry.name,\n            id: entry.name,\n            createdAt: stat.birthtime.toISOString(),\n            size: stat.size,\n          });\n        }\n\n        const offset = listOptions?.cursor ? Number(listOptions.cursor) || 0 : 0;\n        const limit = listOptions?.limit ?? results.length;\n        const sliced =\n          listOptions?.limit !== undefined || offset > 0\n            ? results.slice(offset, offset + limit)\n            : results;\n        const nextCursor =\n          listOptions?.limit !== undefined && offset + sliced.length < results.length\n            ? String(offset + sliced.length)\n            : undefined;\n\n        return toPaginatedListResult(sliced, nextCursor);\n      } catch (err) {\n        if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n          return toPaginatedListResult([]);\n        }\n        throw err;\n      }\n    },\n  };\n}\n","import {\n  type StorageAdapter,\n  type StorageFileEntry,\n  type StorageListOptions,\n  type StoragePaginatedListResult,\n  type StorageUploadParams,\n  type StorageUploadResult,\n  toPaginatedListResult,\n  validateStorageMetadata,\n} from './types';\n\nexport interface S3PutObjectInput {\n  Bucket: string;\n  Key: string;\n  Body: Buffer | Uint8Array;\n  ContentType: string;\n  CacheControl?: string;\n  Metadata?: Record<string, string>;\n  IfNoneMatch?: string;\n}\n\nexport interface S3DeleteObjectInput {\n  Bucket: string;\n  Key: string;\n}\n\nexport interface S3HeadObjectInput {\n  Bucket: string;\n  Key: string;\n}\n\nexport interface S3ListObjectsInput {\n  Bucket: string;\n  Prefix?: string;\n  MaxKeys?: number;\n  ContinuationToken?: string;\n}\n\nexport interface S3ListedObject {\n  Key?: string;\n  Size?: number;\n  LastModified?: Date | string;\n}\n\nexport interface S3ListObjectsOutput {\n  Contents?: S3ListedObject[];\n  NextContinuationToken?: string;\n  IsTruncated?: boolean;\n}\n\n/** Structural S3 / Cloudflare R2 / MinIO transport with zero runtime SDK dependency. */\nexport interface S3TransportLike {\n  putObject(input: S3PutObjectInput): Promise<unknown>;\n  deleteObject(input: S3DeleteObjectInput): Promise<unknown>;\n  headObject?(input: S3HeadObjectInput): Promise<unknown>;\n  listObjects?(input: S3ListObjectsInput): Promise<S3ListObjectsOutput>;\n  listObjectsV2?(input: S3ListObjectsInput): Promise<S3ListObjectsOutput>;\n}\n\nexport type S3PublicUrlBuilder = (bucket: string, path: string) => string;\n\nexport interface S3StorageBaseOptions {\n  /** Public base URL prefix (e.g. `'https://cdn.example.com'`) or `(bucket, path) => string` builder. */\n  publicBaseUrl: string | S3PublicUrlBuilder;\n  /** Default `Cache-Control` header applied when `StorageUploadParams.cacheControl` is omitted. */\n  cacheControl?: string;\n  /** Include `bucket` segment in string-prefix URLs (`${publicBaseUrl}/${bucket}/${path}`). Defaults to `true`. */\n  includeBucketInUrl?: boolean;\n  /** Fallback bucket used by `deleteByUrl` when `includeBucketInUrl` is `false`. */\n  defaultBucket?: string;\n}\n\nexport type S3StorageAdapterOptions = S3StorageBaseOptions &\n  (\n    | (S3TransportLike & { client?: never; transport?: never })\n    | { client: S3TransportLike; transport?: never; putObject?: never }\n    | { transport: S3TransportLike; client?: never; putObject?: never }\n  );\n\nfunction normalizeS3Key(rawPath: string): string {\n  const normalized = rawPath.replace(/\\\\/g, '/').replace(/^\\/+/, '');\n  if (!normalized) throw new Error('Invalid S3 object key');\n  return normalized;\n}\n\nfunction resolveTransport(options: S3StorageAdapterOptions): S3TransportLike {\n  if ('client' in options && options.client) return options.client;\n  if ('transport' in options && options.transport) return options.transport;\n  if ('putObject' in options && typeof options.putObject === 'function') return options;\n  throw new Error('S3StorageAdapter requires putObject/deleteObject or client/transport');\n}\n\nfunction isS3PreconditionError(err: unknown): boolean {\n  if (!err || typeof err !== 'object') return false;\n  const e = err as {\n    code?: unknown;\n    name?: unknown;\n    statusCode?: unknown;\n    $metadata?: { httpStatusCode?: number };\n  };\n  const status = e.$metadata?.httpStatusCode ?? Number(e.statusCode);\n  const code = String(e.code ?? e.name ?? '').toLowerCase();\n  return status === 412 || code === 'preconditionfailed' || code === 'eexist';\n}\n\n/** Zero-dependency S3 / Cloudflare R2 / MinIO `StorageAdapter`. */\nexport function createS3StorageAdapter(options: S3StorageAdapterOptions): StorageAdapter {\n  const transport = resolveTransport(options);\n  const includeBucket = options.includeBucketInUrl !== false;\n\n  const getPublicUrl = (bucket: string, path: string): string => {\n    const key = normalizeS3Key(path);\n    if (typeof options.publicBaseUrl === 'function') return options.publicBaseUrl(bucket, key);\n    const base = options.publicBaseUrl.replace(/\\/+$/, '');\n    return includeBucket ? `${base}/${bucket}/${key}` : `${base}/${key}`;\n  };\n\n  return {\n    async upload(params: StorageUploadParams): Promise<StorageUploadResult> {\n      const key = normalizeS3Key(params.path);\n      validateStorageMetadata(params.metadata);\n\n      const isImmutable =\n        params.upsert === false && params.contentType.includes('image/avif');\n      const cacheControl =\n        params.cacheControl ??\n        options.cacheControl ??\n        (isImmutable\n          ? 'public, max-age=31536000, immutable'\n          : 'public, max-age=2592000, must-revalidate');\n\n      const metadata =\n        params.metadata || params.contentHash\n          ? {\n              ...params.metadata,\n              ...(params.contentHash ? { contentHash: params.contentHash } : {}),\n            }\n          : undefined;\n\n      try {\n        await transport.putObject({\n          Bucket: params.bucket,\n          Key: key,\n          Body: params.data,\n          ContentType: params.contentType,\n          ...(cacheControl ? { CacheControl: cacheControl } : {}),\n          ...(metadata ? { Metadata: metadata } : {}),\n          ...(params.upsert === false ? { IfNoneMatch: '*' } : {}),\n        });\n      } catch (err) {\n        if (isS3PreconditionError(err)) {\n          const existsErr = new Error(\n            `Object already exists at ${params.bucket}/${key}`,\n          ) as Error & { code?: string; statusCode?: number };\n          existsErr.code = 'EEXIST';\n          existsErr.statusCode = 412;\n          throw existsErr;\n        }\n        throw err;\n      }\n\n      return {\n        bucket: params.bucket,\n        path: key,\n        url: getPublicUrl(params.bucket, key),\n      };\n    },\n\n    async delete(bucket: string, path: string): Promise<void> {\n      await transport.deleteObject({ Bucket: bucket, Key: normalizeS3Key(path) });\n    },\n\n    async exists(bucket: string, path: string): Promise<boolean> {\n      const key = normalizeS3Key(path);\n      if (transport.headObject) {\n        try {\n          await transport.headObject({ Bucket: bucket, Key: key });\n          return true;\n        } catch {\n          return false;\n        }\n      }\n      const lastSlash = key.lastIndexOf('/');\n      const folder = lastSlash > 0 ? key.slice(0, lastSlash) : undefined;\n      const targetName = lastSlash > 0 ? key.slice(lastSlash + 1) : key;\n      const listed = await this.list!(bucket, folder);\n      return listed.some((item) => item.name === targetName);\n    },\n\n    getPublicUrl,\n\n    async list(\n      bucket: string,\n      folder?: string,\n      listOptions?: StorageListOptions,\n    ): Promise<StoragePaginatedListResult> {\n      const cleanFolder = folder ? normalizeS3Key(folder).replace(/\\/+$/, '') : '';\n      const prefix = cleanFolder ? `${cleanFolder}/` : undefined;\n      const input: S3ListObjectsInput = {\n        Bucket: bucket,\n        ...(prefix ? { Prefix: prefix } : {}),\n        MaxKeys: listOptions?.limit ?? 1000,\n        ...(listOptions?.cursor ? { ContinuationToken: listOptions.cursor } : {}),\n      };\n\n      const output = transport.listObjects\n        ? await transport.listObjects(input)\n        : transport.listObjectsV2\n          ? await transport.listObjectsV2(input)\n          : undefined;\n\n      const entries: StorageFileEntry[] = (output?.Contents ?? [])\n        .filter((item): item is S3ListedObject & { Key: string } => Boolean(item.Key))\n        .map((item) => {\n          const name =\n            prefix && item.Key.startsWith(prefix)\n              ? item.Key.slice(prefix.length)\n              : item.Key;\n          const createdAt =\n            item.LastModified instanceof Date\n              ? item.LastModified.toISOString()\n              : item.LastModified;\n          return {\n            name,\n            id: `${bucket}/${item.Key}`,\n            ...(createdAt !== undefined ? { createdAt } : {}),\n            ...(item.Size !== undefined ? { size: item.Size } : {}),\n          };\n        })\n        .filter((entry) => entry.name.length > 0);\n\n      return toPaginatedListResult(entries, output?.NextContinuationToken);\n    },\n\n    parseUrl(url: string): { bucket?: string; path: string } | null {\n      if (typeof options.publicBaseUrl !== 'string' || !url) return null;\n      const prefix = `${options.publicBaseUrl.replace(/\\/+$/, '')}/`;\n      const cleanUrl = url.split(/[?#]/)[0];\n      if (!cleanUrl.startsWith(prefix)) return null;\n\n      try {\n        const rest = decodeURIComponent(cleanUrl.slice(prefix.length)).replace(/^\\/+/, '');\n        if (!rest) return null;\n\n        if (includeBucket) {\n          const slashIdx = rest.indexOf('/');\n          if (slashIdx <= 0 || slashIdx === rest.length - 1) return null;\n          return {\n            bucket: rest.slice(0, slashIdx),\n            path: rest.slice(slashIdx + 1),\n          };\n        }\n\n        if (!options.defaultBucket) return null;\n        return { bucket: options.defaultBucket, path: rest };\n      } catch {\n        return null;\n      }\n    },\n\n    async deleteByUrl(url: string): Promise<boolean> {\n      const parsed = this.parseUrl?.(url);\n      if (!parsed || !parsed.bucket) return false;\n\n      try {\n        await transport.deleteObject({\n          Bucket: parsed.bucket,\n          Key: parsed.path,\n        });\n        return true;\n      } catch {\n        return false;\n      }\n    },\n  };\n}\n","import {\n  type StorageAdapter,\n  type StorageListOptions,\n  type StoragePaginatedListResult,\n  type StorageUploadParams,\n  type StorageUploadResult,\n  toPaginatedListResult,\n  validateStorageMetadata,\n} from './types';\nimport {\n  DEFAULT_PUBLIC_STORAGE_PREFIX,\n  parsePublicStorageUrl,\n} from './urlParser';\n\n/**\n * Minimal structural interface matching `@supabase/supabase-js` Storage client,\n * avoiding a mandatory `@supabase/supabase-js` runtime dependency.\n */\nexport interface SupabaseBucketClientLike {\n  upload(\n    path: string,\n    fileBody: Buffer | Uint8Array,\n    fileOptions?: {\n      contentType?: string;\n      upsert?: boolean;\n      cacheControl?: string;\n      metadata?: Record<string, string>;\n    },\n  ): Promise<{\n    data: { path: string } | null;\n    error: { message: string } | null;\n  }>;\n  remove(paths: string[]): Promise<{\n    data?: unknown;\n    error: { message: string } | null;\n  }>;\n  getPublicUrl(path: string): {\n    data: { publicUrl: string };\n  };\n  list?(\n    path?: string,\n    options?: {\n      limit?: number;\n      offset?: number;\n      sortBy?: { column: string; order: string };\n    },\n  ): Promise<{\n    data: Array<{\n      name: string;\n      id: string | null;\n      created_at: string | null;\n    }> | null;\n    error: { message: string } | null;\n  }>;\n}\n\nexport interface SupabaseStorageClientLike {\n  storage: {\n    from(bucket: string): SupabaseBucketClientLike;\n  };\n}\n\nexport interface SupabaseStorageAdapterOptions {\n  publicUrlPrefix?: string;\n}\n\n/**\n * Plug in any `@supabase/supabase-js` client instance (e.g., service-role client)\n * as a `StorageAdapter` with zero extra wrapper boilerplate.\n */\nexport function createSupabaseStorageAdapter(\n  client: SupabaseStorageClientLike,\n  options: SupabaseStorageAdapterOptions = {},\n): StorageAdapter {\n  const publicPrefix =\n    options.publicUrlPrefix || DEFAULT_PUBLIC_STORAGE_PREFIX;\n\n  return {\n    async upload(params: StorageUploadParams): Promise<StorageUploadResult> {\n      validateStorageMetadata(params.metadata);\n\n      const isImmutable =\n        params.upsert === false && params.contentType.includes('image/avif');\n      const cacheControl =\n        params.cacheControl ||\n        (isImmutable\n          ? 'public, max-age=31536000, immutable'\n          : 'public, max-age=2592000, must-revalidate');\n\n      const { data, error } = await client.storage\n        .from(params.bucket)\n        .upload(params.path, params.data, {\n          contentType: params.contentType,\n          upsert: params.upsert === undefined ? true : params.upsert,\n          cacheControl,\n          metadata: {\n            ...params.metadata,\n            uploadedAt: new Date().toISOString(),\n            contentHash: params.contentHash || 'unknown',\n          },\n        });\n\n      if (error || !data) {\n        throw new Error(\n          `Failed to upload to Supabase storage (bucket: ${params.bucket}, path: ${params.path}): ${error?.message || 'Unknown error'}`,\n        );\n      }\n\n      const {\n        data: { publicUrl },\n      } = client.storage.from(params.bucket).getPublicUrl(data.path);\n\n      return {\n        bucket: params.bucket,\n        path: data.path,\n        url: publicUrl,\n      };\n    },\n\n    async delete(bucket: string, path: string): Promise<void> {\n      const { error } = await client.storage.from(bucket).remove([path]);\n      if (error) {\n        throw new Error(`Failed to delete from Supabase storage: ${error.message}`);\n      }\n    },\n\n    async exists(bucket: string, path: string): Promise<boolean> {\n      const cleanPath = path.replace(/^\\/+/, '');\n      const lastSlash = cleanPath.lastIndexOf('/');\n      const folder = lastSlash > 0 ? cleanPath.slice(0, lastSlash) : undefined;\n      const targetName = lastSlash > 0 ? cleanPath.slice(lastSlash + 1) : cleanPath;\n      const entries = await this.list!(bucket, folder);\n      return entries.some((entry) => entry.name === targetName);\n    },\n\n    getPublicUrl(bucket: string, path: string): string {\n      const {\n        data: { publicUrl },\n      } = client.storage.from(bucket).getPublicUrl(path);\n      return publicUrl;\n    },\n\n    async list(\n      bucket: string,\n      folder?: string,\n      listOptions?: StorageListOptions,\n    ): Promise<StoragePaginatedListResult> {\n      const bucketClient = client.storage.from(bucket);\n      if (!bucketClient.list) {\n        return toPaginatedListResult([]);\n      }\n\n      const limit = listOptions?.limit ?? 1000;\n      const offset = listOptions?.cursor ? Number(listOptions.cursor) || 0 : 0;\n\n      const { data, error } = await bucketClient.list(folder, {\n        limit,\n        ...(offset > 0 ? { offset } : {}),\n        sortBy: { column: 'created_at', order: 'desc' },\n      });\n\n      if (error) {\n        throw new Error(`Failed to list Supabase bucket files: ${error.message}`);\n      }\n\n      const entries = (data || [])\n        .filter((f) => f.id !== null)\n        .map((f) => ({\n          name: f.name,\n          id: f.id ?? undefined,\n          createdAt: f.created_at ?? undefined,\n        }));\n\n      const nextCursor =\n        listOptions?.limit !== undefined && entries.length >= limit\n          ? String(offset + entries.length)\n          : undefined;\n\n      return toPaginatedListResult(entries, nextCursor);\n    },\n\n    parseUrl(url: string): { bucket?: string; path: string } | null {\n      const info = parsePublicStorageUrl(url, publicPrefix);\n      if (!info) return null;\n      return { bucket: info.bucket, path: info.path };\n    },\n\n    async deleteByUrl(url: string): Promise<boolean> {\n      const info = parsePublicStorageUrl(url, publicPrefix);\n      if (!info) return false;\n\n      try {\n        const { error } = await client.storage\n          .from(info.bucket)\n          .remove([info.path]);\n        return !error;\n      } catch {\n        return false;\n      }\n    },\n  };\n}\n"]}