@sproux/media-sdk 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # @sproux/media-sdk
 
-Media URL builder library for Sproux — build image variant URLs, video HLS playlist URLs, and thumbnails from original media URLs.
+Media URL builder library for Sproux — build image variant URLs, video HLS playlist URLs, and thumbnails from object keys using a singleton pattern.
 
 ## Installation
 
@@ -18,138 +18,161 @@ yarn add @sproux/media-sdk
 ## Quick Start
 
 ```typescript
-import {
-  buildImageVariantUrl,
-  buildVideoHlsUrl,
-  buildVideoThumbnailUrl,
-  parseMediaUrl,
-} from '@sproux/media-sdk';
+import { SprouxMedia, IMAGE_FORMAT, IMAGE_RESIZE_TYPE } from '@sproux/media-sdk';
+
+// Initialize once (e.g. at app startup)
+const media = SprouxMedia.init({ cdnUrl: 'https://cdn.example.com' });
+
+// Build an image variant URL with all options
+const imageUrl = media.getImageUrl('avatar/image/usr-1/abc.jpg', {
+  extension: IMAGE_FORMAT.WEBP,
+  width: 200,
+  height: 200,
+  resizeType: IMAGE_RESIZE_TYPE.FIT,
+  quality: 80,
+});
+// → "https://cdn.example.com/avatar/image/usr-1/abc-200x200-fit-q80.webp"
 
-// Build an image variant URL
-const imageUrl = buildImageVariantUrl(
-  'https://cdn.example.com/avatar/image/usr-1/profile.jpg',
-  { width: 200, height: 200, resizeType: 'fit', quality: 80 }
-);
-// → "https://cdn.example.com/avatar/image/usr-1/profile-200x200-fit-q80.webp"
+// Or with just the object key (no variant transformation)
+const originalUrl = media.getImageUrl('avatar/image/usr-1/abc.jpg');
+// → "https://cdn.example.com/avatar/image/usr-1/abc.jpg"
 
 // Build a video HLS playlist URL
-const hlsUrl = buildVideoHlsUrl(
-  'https://cdn.example.com/gallery/video/usr-1/intro.mp4'
-);
+const hlsUrl = media.getVideoHlsUrl('gallery/video/usr-1/intro');
 // → "https://cdn.example.com/gallery/video/usr-1/intro/playlist.m3u8"
 
 // Build a video thumbnail URL
-const thumbnailUrl = buildVideoThumbnailUrl(
-  'https://cdn.example.com/gallery/video/usr-1/intro.mp4'
-);
+const thumbUrl = media.getVideoThumbnailUrl('gallery/video/usr-1/intro');
 // → "https://cdn.example.com/gallery/video/usr-1/intro/thumbnail.webp"
 ```
 
-## API Reference
+## Singleton Usage
 
-### `parseMediaUrl(url: string): ParsedMediaUrl`
+```typescript
+import { SprouxMedia, IMAGE_FORMAT, IMAGE_RESIZE_TYPE } from '@sproux/media-sdk';
 
-Parse a media URL into its structured components.
+// Initialize once at startup
+SprouxMedia.init({ cdnUrl: 'https://cdn.example.com' });
 
-**Expected URL pattern:** `{cdnBase}/{purpose}/{type}/{userId}/{name}.{extension}`
+// Access from anywhere via getInstance()
+const media = SprouxMedia.getInstance();
+// With variant options
+const url = media.getImageUrl('avatar/image/usr-1/photo.jpg', {
+  extension: IMAGE_FORMAT.WEBP,
+  width: 400,
+  height: 300,
+  resizeType: IMAGE_RESIZE_TYPE.FILL,
+});
 
-```typescript
-import { parseMediaUrl } from '@sproux/media-sdk';
+// Without options — returns the original URL
+const original = media.getImageUrl('avatar/image/usr-1/photo.jpg');
+```
 
-const parsed = parseMediaUrl('https://cdn.example.com/avatar/image/usr-1/abc.jpg');
-// {
-//   originalUrl: "https://cdn.example.com/avatar/image/usr-1/abc.jpg",
-//   cdnBase: "https://cdn.example.com",
-//   objectKey: "avatar/image/usr-1/abc.jpg",
-//   purpose: "avatar",
-//   type: "image",
-//   userId: "usr-1",
-//   name: "abc",
-//   extension: "jpg"
-// }
+> Calling `getInstance()` before `init()` will throw an error.
+
+## API Reference
+
+### `SprouxMedia.init(config: SprouxMediaConfig): SprouxMedia`
+
+Initialize the singleton with CDN configuration. Returns the singleton instance.
+
+```typescript
+const media = SprouxMedia.init({ cdnUrl: 'https://cdn.example.com' });
 ```
 
-### `buildImageVariantUrl(originalUrl: string, options: ImageVariantOptions): string`
+### `SprouxMedia.getInstance(): SprouxMedia`
+
+Returns the existing singleton instance. Throws if `init()` has not been called.
 
-Build a CDN URL for an image variant with specific dimensions, resize type, and quality.
+### `media.getImageUrl(objectKey: string, options?: ImageUrlOptions): string`
+
+Build a CDN URL for an image variant. When `options` is omitted, returns the original CDN URL for the object key as-is.
+
+- `objectKey` — Object key **with** extension (e.g. `"avatar/image/usr-1/abc.jpg"`)
+- `options` — Optional variant transformation options
 
 ```typescript
-import { buildImageVariantUrl } from '@sproux/media-sdk';
-
-const url = buildImageVariantUrl(
-  'https://cdn.example.com/avatar/image/usr-1/photo.jpg',
-  {
-    width: 400,
-    height: 300,
-    resizeType: 'fill',
-    format: 'webp',  // optional, defaults to 'webp'
-    quality: 85,     // optional
-  }
-);
+import { IMAGE_FORMAT, IMAGE_RESIZE_TYPE } from '@sproux/media-sdk';
+
+// With variant options
+media.getImageUrl('avatar/image/usr-1/photo.jpg', {
+  extension: IMAGE_FORMAT.WEBP,
+  width: 400,
+  height: 300,
+  resizeType: IMAGE_RESIZE_TYPE.FILL,
+  quality: 85,
+});
 // → "https://cdn.example.com/avatar/image/usr-1/photo-400x300-fill-q85.webp"
+
+// Without options — returns the original URL
+media.getImageUrl('avatar/image/usr-1/photo.jpg');
+// → "https://cdn.example.com/avatar/image/usr-1/photo.jpg"
 ```
 
-#### ImageVariantOptions
+#### ImageUrlOptions
 
-| Property     | Type              | Required | Description                           |
-| ------------ | ----------------- | -------- | ------------------------------------- |
-| `width`      | `number`          | Yes      | Target width in pixels (1-4096)       |
-| `height`     | `number`          | Yes      | Target height in pixels (1-4096)      |
-| `resizeType` | `ImageResizeType` | Yes      | Resize strategy: `fit`, `fill`, `auto` |
-| `format`     | `ImageFormat`     | No       | Output format (default: `webp`)       |
-| `quality`    | `number`          | No       | Quality 1-100                         |
+All fields are optional.
 
-### `buildVideoHlsUrl(originalUrl: string): string`
+| Property     | Type              | Required | Description                            |
+| ------------ | ----------------- | -------- | -------------------------------------- |
+| `extension`  | `ImageFormat`     | No       | Output format (`webp`, `avif`, `jpeg`, `png`, `gif`, `ico`, `svg`, `jpg`) |
+| `width`      | `number`          | No       | Target width in pixels (1–4096)        |
+| `height`     | `number`          | No       | Target height in pixels (1–4096)       |
+| `resizeType` | `ImageResizeType` | No       | Resize strategy: `fit`, `fill`, `force`, `fill-down`, `auto` |
+| `quality`    | `number`          | No       | Quality 1–100                          |
 
-Build an HLS playlist URL from an original video URL.
+### `media.getVideoHlsUrl(objectKey: string): string`
 
-```typescript
-import { buildVideoHlsUrl } from '@sproux/media-sdk';
+Build an HLS playlist URL from an object key (without extension).
 
-const hlsUrl = buildVideoHlsUrl(
-  'https://cdn.example.com/gallery/video/usr-1/video.mp4'
-);
+```typescript
+media.getVideoHlsUrl('gallery/video/usr-1/video');
 // → "https://cdn.example.com/gallery/video/usr-1/video/playlist.m3u8"
 ```
 
-### `buildVideoThumbnailUrl(originalUrl: string): string`
+### `media.getVideoThumbnailUrl(objectKey: string): string`
 
-Build a thumbnail URL from an original video URL.
+Build a thumbnail URL from an object key (without extension).
 
 ```typescript
-import { buildVideoThumbnailUrl } from '@sproux/media-sdk';
-
-const thumbnailUrl = buildVideoThumbnailUrl(
-  'https://cdn.example.com/gallery/video/usr-1/video.mp4'
-);
+media.getVideoThumbnailUrl('gallery/video/usr-1/video');
 // → "https://cdn.example.com/gallery/video/usr-1/video/thumbnail.webp"
 ```
 
-### `buildVariantString(options: ImageVariantOptions): string`
+## Enums
 
-Build a deterministic variant string from image variant options. This is used internally by `buildImageVariantUrl`.
+Use the provided enums for type-safe image options:
 
 ```typescript
-import { buildVariantString } from '@sproux/media-sdk';
-
-buildVariantString({ width: 200, height: 200, resizeType: 'fit' });
-// → "200x200-fit"
-
-buildVariantString({ width: 200, height: 200, resizeType: 'fit', quality: 80 });
-// → "200x200-fit-q80"
+import { IMAGE_FORMAT, IMAGE_RESIZE_TYPE } from '@sproux/media-sdk';
+
+// IMAGE_FORMAT
+IMAGE_FORMAT.WEBP   // 'webp'
+IMAGE_FORMAT.AVIF   // 'avif'
+IMAGE_FORMAT.JPEG   // 'jpeg'
+IMAGE_FORMAT.PNG    // 'png'
+IMAGE_FORMAT.GIF    // 'gif'
+IMAGE_FORMAT.ICO    // 'ico'
+IMAGE_FORMAT.SVG    // 'svg'
+IMAGE_FORMAT.JPG    // 'jpg'
+
+// IMAGE_RESIZE_TYPE
+IMAGE_RESIZE_TYPE.FIT       // 'fit'
+IMAGE_RESIZE_TYPE.FILL      // 'fill'
+IMAGE_RESIZE_TYPE.FORCE     // 'force'
+IMAGE_RESIZE_TYPE.FILL_DOWN // 'fill-down'
+IMAGE_RESIZE_TYPE.AUTO      // 'auto'
 ```
 
 ## Constants
 
-The SDK exports constants for type-safe usage:
-
 ```typescript
 import {
-  MEDIA_TYPE,       // { IMAGE: 'image', VIDEO: 'video' }
-  MEDIA_PURPOSE,    // { AVATAR: 'avatar', HERO: 'hero', GALLERY: 'gallery' }
-  MEDIA_STATUS,     // { PENDING, UPLOADED, PROCESSING, READY, ERROR }
-  IMAGE_FORMAT,     // { WEBP, AVIF, JPEG, PNG, JPG }
-  IMAGE_RESIZE_TYPE // { FIT, FILL, AUTO }
+  MEDIA_TYPE,     // { IMAGE: 'image', VIDEO: 'video' }
+  MEDIA_PURPOSE,  // { AVATAR: 'avatar', HERO: 'hero', GALLERY: 'gallery' }
+  MEDIA_STATUS,   // { PENDING, UPLOADED, PROCESSING, READY, ERROR }
+  R2_PATH,        // { HLS_PLAYLIST: 'playlist.m3u8', THUMBNAIL: 'thumbnail.webp' }
+  MEDIA_DEFAULTS, // { IMAGE_FORMAT: 'webp' }
 } from '@sproux/media-sdk';
 ```
 
@@ -157,50 +180,35 @@ import {
 
 ```typescript
 import type {
-  MediaType,           // 'image' | 'video'
-  MediaPurpose,        // 'avatar' | 'hero' | 'gallery'
-  MediaStatus,         // 'pending' | 'uploaded' | 'processing' | 'ready' | 'error'
-  ImageFormat,         // 'webp' | 'avif' | 'jpeg' | 'png' | 'jpg'
-  ImageResizeType,     // 'fit' | 'fill' | 'auto'
-  ParsedMediaUrl,
-  ImageVariantOptions,
+  ImageFormat,       // 'webp' | 'avif' | 'jpeg' | 'png' | 'gif' | 'ico' | 'svg' | 'jpg'
+  ImageResizeType,   // 'fit' | 'fill' | 'force' | 'fill-down' | 'auto'
+  SprouxMediaConfig, // { cdnUrl: string }
+  ImageUrlOptions,   // { extension?, width?, height?, resizeType?, quality? }
 } from '@sproux/media-sdk';
 ```
 
-## URL Structure
-
-This SDK expects media URLs to follow this structure:
+> `ImageFormat` and `ImageResizeType` are string union types derived from their respective enums. You can use either the enum values (`IMAGE_FORMAT.WEBP`) or raw strings (`'webp'`).
 
-```
-{cdnBase}/{purpose}/{type}/{userId}/{filename}
-```
-
-| Segment    | Description                               | Valid Values                      |
-| ---------- | ----------------------------------------- | --------------------------------- |
-| `cdnBase`  | CDN origin including protocol             | Any valid URL origin              |
-| `purpose`  | Media use case                            | `avatar`, `hero`, `gallery`       |
-| `type`     | Media type                                | `image`, `video`                  |
-| `userId`   | User identifier                           | Any string                        |
-| `filename` | File name with extension                  | `{name}.{extension}`              |
+## URL Structure
 
-### Image Variant URL Structure
+### Image Variant URL
 
 ```
-{cdnBase}/{purpose}/image/{userId}/{name}-{width}x{height}-{resizeType}[-q{quality}].{format}
+{cdnUrl}/{objectKey}-{width}x{height}-{resizeType}[-q{quality}].{extension}
 ```
 
 Example: `https://cdn.example.com/avatar/image/usr-1/photo-200x200-fit-q80.webp`
 
-### Video HLS URL Structure
+### Video HLS URL
 
 ```
-{cdnBase}/{purpose}/video/{userId}/{name}/playlist.m3u8
+{cdnUrl}/{objectKey}/playlist.m3u8
 ```
 
-### Video Thumbnail URL Structure
+### Video Thumbnail URL
 
 ```
-{cdnBase}/{purpose}/video/{userId}/{name}/thumbnail.webp
+{cdnUrl}/{objectKey}/thumbnail.webp
 ```
 
 ## License

package/dist/index.cjs

@@ -27,11 +27,7 @@ __export(index_exports, {
   MEDIA_STATUS: () => MEDIA_STATUS,
   MEDIA_TYPE: () => MEDIA_TYPE,
   R2_PATH: () => R2_PATH,
-  buildImageVariantUrl: () => buildImageVariantUrl,
-  buildVariantString: () => buildVariantString,
-  buildVideoHlsUrl: () => buildVideoHlsUrl,
-  buildVideoThumbnailUrl: () => buildVideoThumbnailUrl,
-  parseMediaUrl: () => parseMediaUrl
+  SprouxMedia: () => SprouxMedia
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -52,136 +48,160 @@ var MEDIA_STATUS = {
   READY: "ready",
   ERROR: "error"
 };
-var IMAGE_FORMAT = {
-  WEBP: "webp",
-  AVIF: "avif",
-  JPEG: "jpeg",
-  PNG: "png",
-  JPG: "jpg"
-};
-var IMAGE_RESIZE_TYPE = {
-  FIT: "fit",
-  FILL: "fill",
-  AUTO: "auto"
-};
+var IMAGE_FORMAT = /* @__PURE__ */ ((IMAGE_FORMAT2) => {
+  IMAGE_FORMAT2["WEBP"] = "webp";
+  IMAGE_FORMAT2["AVIF"] = "avif";
+  IMAGE_FORMAT2["JPEG"] = "jpeg";
+  IMAGE_FORMAT2["PNG"] = "png";
+  IMAGE_FORMAT2["GIF"] = "gif";
+  IMAGE_FORMAT2["ICO"] = "ico";
+  IMAGE_FORMAT2["SVG"] = "svg";
+  IMAGE_FORMAT2["JPG"] = "jpg";
+  return IMAGE_FORMAT2;
+})(IMAGE_FORMAT || {});
+var IMAGE_RESIZE_TYPE = /* @__PURE__ */ ((IMAGE_RESIZE_TYPE2) => {
+  IMAGE_RESIZE_TYPE2["FIT"] = "fit";
+  IMAGE_RESIZE_TYPE2["FILL"] = "fill";
+  IMAGE_RESIZE_TYPE2["FORCE"] = "force";
+  IMAGE_RESIZE_TYPE2["FILL_DOWN"] = "fill-down";
+  IMAGE_RESIZE_TYPE2["AUTO"] = "auto";
+  return IMAGE_RESIZE_TYPE2;
+})(IMAGE_RESIZE_TYPE || {});
 var R2_PATH = {
   HLS_PLAYLIST: "playlist.m3u8",
   THUMBNAIL: "thumbnail.webp"
 };
 var MEDIA_DEFAULTS = {
-  IMAGE_FORMAT: IMAGE_FORMAT.WEBP
+  IMAGE_FORMAT: "webp" /* WEBP */
 };
 
-// src/parse-media-url.ts
-var VALID_PURPOSES = new Set(Object.values(MEDIA_PURPOSE));
-var VALID_TYPES = new Set(Object.values(MEDIA_TYPE));
-function parseMediaUrl(originalUrl) {
-  let url;
-  try {
-    url = new URL(originalUrl);
-  } catch {
-    throw new Error(`Invalid media URL: "${originalUrl}"`);
-  }
-  const pathname = url.pathname.startsWith("/") ? url.pathname.slice(1) : url.pathname;
-  const segments = pathname.split("/");
-  if (segments.length < 4) {
-    throw new Error(
-      `Invalid media URL path: expected at least 4 segments (purpose/type/userId/filename), got ${segments.length} in "${pathname}"`
-    );
-  }
-  const [purpose, type, userId, filename] = segments;
-  if (!VALID_PURPOSES.has(purpose)) {
-    throw new Error(
-      `Invalid media purpose: "${purpose}". Expected one of: ${[...VALID_PURPOSES].join(", ")}`
-    );
-  }
-  if (!VALID_TYPES.has(type)) {
-    throw new Error(
-      `Invalid media type: "${type}". Expected one of: ${[...VALID_TYPES].join(", ")}`
-    );
-  }
-  if (!userId) {
-    throw new Error("Missing userId segment in media URL");
-  }
-  if (!filename) {
-    throw new Error("Missing filename segment in media URL");
-  }
-  const dotIndex = filename.lastIndexOf(".");
-  if (dotIndex <= 0) {
-    throw new Error(`Invalid filename: "${filename}". Expected format: "name.extension"`);
-  }
-  const name = filename.slice(0, dotIndex);
-  const extension = filename.slice(dotIndex + 1);
-  if (!extension) {
-    throw new Error(`Missing file extension in filename: "${filename}"`);
-  }
-  const cdnBase = `${url.protocol}//${url.host}`;
-  const objectKey = pathname;
-  return {
-    originalUrl,
-    cdnBase,
-    objectKey,
-    purpose,
-    type,
-    userId,
-    name,
-    extension
-  };
-}
-
-// src/build-variant-string.ts
-function buildVariantString(options) {
-  validateVariantOptions(options);
-  const parts = [`${options.width}x${options.height}`, options.resizeType];
-  if (options.quality != null) {
-    parts.push(`q${options.quality}`);
-  }
-  return parts.join("-");
-}
-function validateVariantOptions(options) {
-  if (!Number.isInteger(options.width) || options.width < 1 || options.width > 4096) {
-    throw new Error(`Invalid width: ${options.width}. Must be an integer between 1 and 4096.`);
-  }
-  if (!Number.isInteger(options.height) || options.height < 1 || options.height > 4096) {
-    throw new Error(`Invalid height: ${options.height}. Must be an integer between 1 and 4096.`);
-  }
-  if (options.quality != null) {
-    if (!Number.isInteger(options.quality) || options.quality < 1 || options.quality > 100) {
-      throw new Error(
-        `Invalid quality: ${options.quality}. Must be an integer between 1 and 100.`
-      );
+// src/sproux-media.ts
+var SprouxMedia = class _SprouxMedia {
+  static instance = null;
+  cdnUrl;
+  constructor(config) {
+    this.cdnUrl = config.cdnUrl.replace(/\/+$/, "");
+  }
+  /**
+   * Initialize the singleton with CDN configuration.
+   * Returns the singleton instance.
+   */
+  static init(config) {
+    if (_SprouxMedia.instance) {
+      return _SprouxMedia.instance;
     }
+    return _SprouxMedia.instance = new _SprouxMedia(config);
+  }
+  /**
+   * Returns the existing singleton instance.
+   * Throws if `init()` has not been called.
+   */
+  static getInstance() {
+    if (!_SprouxMedia.instance) {
+      throw new Error("SprouxMedia has not been initialized. Call SprouxMedia.init() first.");
+    }
+    return _SprouxMedia.instance;
+  }
+  /**
+   * Build a CDN URL for an image, optionally with variant transformation.
+   *
+   * @param objectKey - Object key with extension (e.g. "avatar/image/usr-1/abc.jpg")
+   * @param options - Optional image variant options (extension, dimensions, resize type, quality)
+   * @returns Full CDN URL — variant URL if options are provided, original URL otherwise
+   *
+   * @example
+   * // With variant options
+   * media.getImageUrl('avatar/image/usr-1/abc.jpg', {
+   *   extension: 'webp', width: 200, height: 200, resizeType: 'fit', quality: 80,
+   * });
+   * // → "https://cdn.example.com/avatar/image/usr-1/abc-200x200-fit-q80.webp"
+   *
+   * @example
+   * // Without options — returns the original URL
+   * media.getImageUrl('avatar/image/usr-1/abc.jpg');
+   * // → "https://cdn.example.com/avatar/image/usr-1/abc.jpg"
+   */
+  getImageUrl(objectKey, options) {
+    if (!options || Object.keys(options).length === 0) {
+      return `${this.cdnUrl}/${objectKey}`;
+    }
+    this.validateImageOptions(options);
+    const { name, extension: originalExt } = this.parseObjectKey(objectKey);
+    const ext = options.extension ?? originalExt;
+    const variant = this.buildVariantString(options);
+    return variant ? `${this.cdnUrl}/${name}-${variant}.${ext}` : `${this.cdnUrl}/${objectKey}`;
+  }
+  /**
+   * Build a CDN URL for a video HLS playlist.
+   *
+   * @param objectKey - Object key without extension (e.g. "gallery/video/usr-1/xyz")
+   * @returns Full CDN URL for the HLS playlist
+   */
+  getVideoHlsUrl(objectKey) {
+    return `${this.cdnUrl}/${objectKey}/${R2_PATH.HLS_PLAYLIST}`;
+  }
+  /**
+   * Build a CDN URL for a video thumbnail.
+   *
+   * @param objectKey - Object key without extension (e.g. "gallery/video/usr-1/xyz")
+   * @returns Full CDN URL for the thumbnail
+   */
+  getVideoThumbnailUrl(objectKey) {
+    return `${this.cdnUrl}/${objectKey}/${R2_PATH.THUMBNAIL}`;
+  }
+  /**
+   * Parse an object key into name (path without extension) and extension.
+   */
+  parseObjectKey(objectKey) {
+    const lastDot = objectKey.lastIndexOf(".");
+    if (lastDot === -1) {
+      return { name: objectKey, extension: "" };
+    }
+    return {
+      name: objectKey.substring(0, lastDot),
+      extension: objectKey.substring(lastDot + 1)
+    };
+  }
+  /**
+   * Build a deterministic variant string from image options.
+   *
+   * Format: {width}x{height}-{resizeType}[-q{quality}]
+   */
+  buildVariantString(options) {
+    const parts = [];
+    if (options.width != null && options.height != null) {
+      parts.push(`${options.width}x${options.height}`);
+    }
+    if (options.resizeType != null) {
+      parts.push(options.resizeType);
+    }
+    if (options.quality != null) {
+      parts.push(`q${options.quality}`);
+    }
+    return parts.join("-");
   }
-}
-
-// src/build-image-variant-url.ts
-function buildImageVariantUrl(originalUrl, options) {
-  const parsed = parseMediaUrl(originalUrl);
-  if (parsed.type !== "image") {
-    throw new Error(`Expected image URL, got type "${parsed.type}" in "${originalUrl}"`);
-  }
-  const variant = buildVariantString(options);
-  const format = options.format ?? MEDIA_DEFAULTS.IMAGE_FORMAT;
-  return `${parsed.cdnBase}/${parsed.purpose}/${parsed.type}/${parsed.userId}/${parsed.name}-${variant}.${format}`;
-}
-
-// src/build-video-hls-url.ts
-function buildVideoHlsUrl(originalUrl) {
-  const parsed = parseMediaUrl(originalUrl);
-  if (parsed.type !== "video") {
-    throw new Error(`Expected video URL, got type "${parsed.type}" in "${originalUrl}"`);
-  }
-  return `${parsed.cdnBase}/${parsed.purpose}/video/${parsed.userId}/${parsed.name}/${R2_PATH.HLS_PLAYLIST}`;
-}
-
-// src/build-video-thumbnail-url.ts
-function buildVideoThumbnailUrl(originalUrl) {
-  const parsed = parseMediaUrl(originalUrl);
-  if (parsed.type !== "video") {
-    throw new Error(`Expected video URL, got type "${parsed.type}" in "${originalUrl}"`);
+  validateImageOptions(options) {
+    if (options.width != null) {
+      if (!Number.isInteger(options.width) || options.width < 1 || options.width > 4096) {
+        throw new Error(`Invalid width: ${options.width}. Must be an integer between 1 and 4096.`);
+      }
+    }
+    if (options.height != null) {
+      if (!Number.isInteger(options.height) || options.height < 1 || options.height > 4096) {
+        throw new Error(
+          `Invalid height: ${options.height}. Must be an integer between 1 and 4096.`
+        );
+      }
+    }
+    if (options.quality != null) {
+      if (!Number.isInteger(options.quality) || options.quality < 1 || options.quality > 100) {
+        throw new Error(
+          `Invalid quality: ${options.quality}. Must be an integer between 1 and 100.`
+        );
+      }
+    }
   }
-  return `${parsed.cdnBase}/${parsed.purpose}/video/${parsed.userId}/${parsed.name}/${R2_PATH.THUMBNAIL}`;
-}
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   IMAGE_FORMAT,
@@ -191,10 +211,6 @@ function buildVideoThumbnailUrl(originalUrl) {
   MEDIA_STATUS,
   MEDIA_TYPE,
   R2_PATH,
-  buildImageVariantUrl,
-  buildVariantString,
-  buildVideoHlsUrl,
-  buildVideoThumbnailUrl,
-  parseMediaUrl
+  SprouxMedia
 });
 //# sourceMappingURL=index.cjs.map