img-upload-kit 0.0.0-stage → 2.0.0

package/dist/storage.js

@@ -0,0 +1,447 @@
+import {
+  createMemoryStorageAdapter,
+  createStorageAdapter,
+  toPaginatedListResult,
+  validateStorageMetadata
+} from "./chunk-CV23O4YU.js";
+import {
+  DEFAULT_PUBLIC_STORAGE_PREFIX,
+  parsePublicStorageUrl
+} from "./chunk-S2IFAWJK.js";
+
+// src/storage/localFsAdapter.ts
+import fs from "fs/promises";
+import path from "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 = path.relative(resolvedRoot, targetPath);
+  if (relative.startsWith("..") || path.isAbsolute(relative)) {
+    throw new Error("Path traversal blocked in LocalFsStorageAdapter");
+  }
+}
+function createLocalFsStorageAdapter(options) {
+  const resolvedRoot = path.resolve(options.rootDir);
+  const baseUrl = (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 = path.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 = path.resolve(resolvedRoot, ...segments);
+      const relative = path.relative(resolvedRoot, diskPath);
+      if (relative.startsWith("..") || path.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 {
+      return null;
+    }
+  };
+  return {
+    async upload(params) {
+      const { diskPath, cleanRel } = resolveDiskTarget(
+        params.bucket,
+        params.path
+      );
+      await fs.mkdir(path.dirname(diskPath), { recursive: true });
+      try {
+        await fs.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 fs.unlink(diskPath);
+      } catch (err) {
+        if (err.code !== "ENOENT") {
+          throw err;
+        }
+      }
+    },
+    async exists(bucket, relativePath) {
+      try {
+        const { diskPath } = resolveDiskTarget(bucket, relativePath);
+        const stat = await fs.stat(diskPath);
+        return stat.isFile();
+      } catch {
+        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 = path.resolve(resolvedRoot, ...subSegments);
+        assertContainedInRoot(resolvedRoot, diskPath);
+        await fs.unlink(diskPath);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    async list(bucket, folder, listOptions) {
+      const cleanBucket = sanitizeRelativePath(bucket);
+      const cleanFolder = folder ? sanitizeRelativePath(folder) : "";
+      const targetDir = path.resolve(
+        resolvedRoot,
+        includeBucket ? cleanBucket : "",
+        cleanFolder
+      );
+      assertContainedInRoot(resolvedRoot, targetDir);
+      try {
+        const dirEntries = await fs.readdir(targetDir, { withFileTypes: true });
+        const results = [];
+        for (const entry of dirEntries) {
+          if (!entry.isFile()) continue;
+          const full = path.join(targetDir, entry.name);
+          const stat = await fs.stat(full);
+          results.push({
+            name: entry.name,
+            id: entry.name,
+            createdAt: stat.birthtime.toISOString(),
+            size: stat.size
+          });
+        }
+        const offset = listOptions?.cursor ? Number(listOptions.cursor) || 0 : 0;
+        const limit = listOptions?.limit ?? results.length;
+        const sliced = listOptions?.limit !== void 0 || offset > 0 ? results.slice(offset, offset + limit) : results;
+        const nextCursor = listOptions?.limit !== void 0 && offset + sliced.length < results.length ? String(offset + sliced.length) : void 0;
+        return toPaginatedListResult(sliced, nextCursor);
+      } catch (err) {
+        if (err.code === "ENOENT") {
+          return toPaginatedListResult([]);
+        }
+        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 = e.$metadata?.httpStatusCode ?? Number(e.statusCode);
+  const code = String(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);
+      validateStorageMetadata(params.metadata);
+      const isImmutable = params.upsert === false && params.contentType.includes("image/avif");
+      const cacheControl = 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 {
+          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: listOptions?.limit ?? 1e3,
+        ...listOptions?.cursor ? { ContinuationToken: listOptions.cursor } : {}
+      };
+      const output = transport.listObjects ? await transport.listObjects(input) : transport.listObjectsV2 ? await transport.listObjectsV2(input) : void 0;
+      const entries = (output?.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 toPaginatedListResult(entries, output?.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 {
+        return null;
+      }
+    },
+    async deleteByUrl(url) {
+      const parsed = this.parseUrl?.(url);
+      if (!parsed || !parsed.bucket) return false;
+      try {
+        await transport.deleteObject({
+          Bucket: parsed.bucket,
+          Key: parsed.path
+        });
+        return true;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+
+// src/storage/supabaseAdapter.ts
+function createSupabaseStorageAdapter(client, options = {}) {
+  const publicPrefix = options.publicUrlPrefix || DEFAULT_PUBLIC_STORAGE_PREFIX;
+  return {
+    async upload(params) {
+      validateStorageMetadata(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}): ${error?.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 toPaginatedListResult([]);
+      }
+      const limit = listOptions?.limit ?? 1e3;
+      const offset = listOptions?.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: f.id ?? void 0,
+        createdAt: f.created_at ?? void 0
+      }));
+      const nextCursor = listOptions?.limit !== void 0 && entries.length >= limit ? String(offset + entries.length) : void 0;
+      return toPaginatedListResult(entries, nextCursor);
+    },
+    parseUrl(url) {
+      const info = parsePublicStorageUrl(url, publicPrefix);
+      if (!info) return null;
+      return { bucket: info.bucket, path: info.path };
+    },
+    async deleteByUrl(url) {
+      const info = parsePublicStorageUrl(url, publicPrefix);
+      if (!info) return false;
+      try {
+        const { error } = await client.storage.from(info.bucket).remove([info.path]);
+        return !error;
+      } catch {
+        return false;
+      }
+    }
+  };
+}
+export {
+  DEFAULT_PUBLIC_STORAGE_PREFIX,
+  createLocalFsStorageAdapter,
+  createMemoryStorageAdapter,
+  createS3StorageAdapter,
+  createStorageAdapter,
+  createSupabaseStorageAdapter,
+  parsePublicStorageUrl,
+  toPaginatedListResult,
+  validateStorageMetadata
+};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/localFsAdapter.ts","../src/storage/s3Adapter.ts","../src/storage/supabaseAdapter.ts"],"sourcesContent":["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"],"mappings":"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","names":["path","path"]}

package/dist/styles/animated-image.css

@@ -0,0 +1,112 @@
+/* ── AnimatedImage: blur-up crossfade image (Imagine-Global parity) ─────── */
+.iuk-animated-image {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  overflow: clip;
+  border-radius: inherit;
+  clip-path: inset(0 round inherit);
+  contain: paint;
+  transition: background-color var(--iuk-animated-image-color-transition, 300ms ease);
+}
+
+.iuk-animated-image--fill {
+  position: absolute;
+  inset: 0;
+}
+
+.iuk-animated-image__placeholder {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  object-position: center;
+  /* Tiny placeholder stretched to full size is blurred and scaled slightly so
+     blurred edges stay clipped inside the overflow: hidden wrapper. */
+  filter: blur(var(--iuk-animated-image-blur, 20px));
+  transform: scale(var(--iuk-animated-image-placeholder-scale, 1.1));
+  transform-origin: center;
+  z-index: 1;
+  opacity: 1;
+  transition: opacity var(--iuk-ai-ph-dur, 500ms) ease-in-out;
+  pointer-events: none;
+}
+
+.iuk-animated-image__placeholder--hidden {
+  opacity: 0;
+}
+
+.iuk-animated-image__img {
+  position: relative;
+  display: block;
+  z-index: 2;
+  width: 100%;
+  height: auto;
+  opacity: 0;
+  transform: scale(var(--iuk-animated-image-reveal-scale, 1.02));
+  border-radius: inherit;
+  user-select: none;
+  -webkit-user-select: none;
+  -webkit-user-drag: none;
+  transition:
+    opacity var(--iuk-animated-image-duration, 600ms) ease-in-out,
+    transform var(--iuk-animated-image-duration, 600ms) ease-in-out;
+}
+
+.iuk-animated-image__img[data-state='loaded'] {
+  opacity: 1;
+  transform: scale(1);
+}
+
+.iuk-animated-image__img[data-state='error'] {
+  opacity: 0;
+  visibility: hidden;
+}
+
+.iuk-animated-image--fill .iuk-animated-image__img {
+  position: absolute;
+  inset: 0;
+  height: 100%;
+}
+
+/* In contain mode, the generated blur placeholder stays visible with object-fit: cover
+   and scale(1.1) behind the contained image so letterbox/pillarbox bars show the blur. */
+.iuk-animated-image--contain .iuk-animated-image__img {
+  transform: none;
+}
+
+.iuk-animated-image__shimmer {
+  position: absolute;
+  inset: 0;
+  z-index: 3;
+  background: linear-gradient(
+    90deg,
+    transparent 0%,
+    var(--iuk-animated-image-shimmer, rgba(255, 255, 255, 0.1)) 50%,
+    transparent 100%
+  );
+  animation: iuk-animated-image-shimmer 2s infinite;
+  pointer-events: none;
+}
+
+.iuk-animated-image__shimmer--hidden {
+  opacity: 0;
+}
+
+@keyframes iuk-animated-image-shimmer {
+  from { transform: translateX(-100%); }
+  to { transform: translateX(100%); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .iuk-animated-image__img,
+  .iuk-animated-image__placeholder {
+    transform: none !important;
+    transition-duration: 0ms !important;
+    transition-delay: 0ms !important;
+  }
+  .iuk-animated-image__shimmer {
+    animation: none;
+  }
+}