npm - @sproux/media-sdk - Versions diffs - 0.1.0 → 0.1.1 - Mend

@sproux/media-sdk 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -14,115 +14,99 @@ declare const MEDIA_STATUS: {
     readonly READY: "ready";
     readonly ERROR: "error";
 };
-declare const IMAGE_FORMAT: {
-    readonly WEBP: "webp";
-    readonly AVIF: "avif";
-    readonly JPEG: "jpeg";
-    readonly PNG: "png";
-    readonly JPG: "jpg";
-};
-declare const IMAGE_RESIZE_TYPE: {
-    readonly FIT: "fit";
-    readonly FILL: "fill";
-    readonly AUTO: "auto";
-};
+declare enum IMAGE_FORMAT {
+    WEBP = "webp",
+    AVIF = "avif",
+    JPEG = "jpeg",
+    PNG = "png",
+    GIF = "gif",
+    ICO = "ico",
+    SVG = "svg",
+    JPG = "jpg"
+}
+declare enum IMAGE_RESIZE_TYPE {
+    FIT = "fit",
+    FILL = "fill",
+    FORCE = "force",
+    FILL_DOWN = "fill-down",
+    AUTO = "auto"
+}
 declare const R2_PATH: {
     readonly HLS_PLAYLIST: "playlist.m3u8";
     readonly THUMBNAIL: "thumbnail.webp";
 };
 declare const MEDIA_DEFAULTS: {
-    readonly IMAGE_FORMAT: "webp";
+    readonly IMAGE_FORMAT: IMAGE_FORMAT.WEBP;
 };
-type MediaType = (typeof MEDIA_TYPE)[keyof typeof MEDIA_TYPE];
-type MediaPurpose = (typeof MEDIA_PURPOSE)[keyof typeof MEDIA_PURPOSE];
-type MediaStatus = (typeof MEDIA_STATUS)[keyof typeof MEDIA_STATUS];
-type ImageFormat = (typeof IMAGE_FORMAT)[keyof typeof IMAGE_FORMAT];
-type ImageResizeType = (typeof IMAGE_RESIZE_TYPE)[keyof typeof IMAGE_RESIZE_TYPE];
-interface ParsedMediaUrl {
-    /** Full original URL */
-    originalUrl: string;
-    /** CDN base including protocol and host */
-    cdnBase: string;
-    /** Object key without CDN base */
-    objectKey: string;
-    /** Purpose segment: avatar, hero, gallery */
-    purpose: MediaPurpose;
-    /** Type segment: image, video */
-    type: MediaType;
-    /** User ID segment */
-    userId: string;
-    /** File name without extension */
-    name: string;
-    /** File extension without dot */
-    extension: string;
+type ImageFormat = `${IMAGE_FORMAT}`;
+type ImageResizeType = `${IMAGE_RESIZE_TYPE}`;
+interface SprouxMediaConfig {
+    /** CDN base URL including protocol and host (e.g. "https://cdn.example.com") */
+    cdnUrl: string;
 }
-interface ImageVariantOptions {
+interface ImageUrlOptions {
+    /** Output format extension (e.g. "webp", "avif") */
+    extension: ImageFormat;
     /** Target width in pixels (1-4096) */
     width: number;
     /** Target height in pixels (1-4096) */
     height: number;
     /** Resize type: fit, fill, auto */
     resizeType: ImageResizeType;
-    /** Output format (default: webp) */
-    format?: ImageFormat;
-    /** Quality 1-100 */
+    /** Quality 1-100 (optional) */
     quality?: number;
 }
-/**
- * Parse a full media URL into structured components.
- *
- * Expected URL pattern:
- *   {cdnBase}/{purpose}/{type}/{userId}/{name}.{extension}
- *
- * Example:
- *   https://cdn.example.com/avatar/image/usr-1/abc.jpg
- *   → { cdnBase: "https://cdn.example.com", purpose: "avatar", type: "image", userId: "usr-1", name: "abc", extension: "jpg" }
- */
-declare function parseMediaUrl(originalUrl: string): ParsedMediaUrl;
-/**
- * Build a deterministic variant string from image variant options.
- *
- * Format: {width}x{height}-{resizeType}[-q{quality}]
- *
- * Examples:
- *   { width: 200, height: 200, resizeType: 'fit' }            → "200x200-fit"
- *   { width: 200, height: 200, resizeType: 'fit', quality: 80 } → "200x200-fit-q80"
- */
-declare function buildVariantString(options: ImageVariantOptions): string;
-/**
- * Build a full CDN URL for an image variant.
- *
- * Takes an original image URL and variant options, returns the CDN URL
- * for that specific variant.
- *
- * Example:
- *   buildImageVariantUrl("https://cdn.example.com/avatar/image/usr-1/abc.jpg", {
- *     width: 200, height: 200, resizeType: 'fit', quality: 80
- *   })
- *   → "https://cdn.example.com/avatar/image/usr-1/abc-200x200-fit-q80.webp"
- */
-declare function buildImageVariantUrl(originalUrl: string, options: ImageVariantOptions): string;
-/**
- * Build HLS playlist URL from an original video URL.
- *
- * Example:
- *   buildVideoHlsUrl("https://cdn.example.com/gallery/video/usr-1/xyz.mp4")
- *   → "https://cdn.example.com/gallery/video/usr-1/xyz/playlist.m3u8"
- */
-declare function buildVideoHlsUrl(originalUrl: string): string;
-/**
- * Build thumbnail URL from an original video URL.
- *
- * Example:
- *   buildVideoThumbnailUrl("https://cdn.example.com/gallery/video/usr-1/xyz.mp4")
- *   → "https://cdn.example.com/gallery/video/usr-1/xyz/thumbnail.webp"
- */
-declare function buildVideoThumbnailUrl(originalUrl: string): string;
+declare class SprouxMedia {
+    private static instance;
+    private readonly cdnUrl;
+    private constructor();
+    /**
+     * Initialize the singleton with CDN configuration.
+     * Returns the singleton instance.
+     */
+    static init(config: SprouxMediaConfig): SprouxMedia;
+    /**
+     * Returns the existing singleton instance.
+     * Throws if `init()` has not been called.
+     */
+    static getInstance(): SprouxMedia;
+    /**
+     * Build a CDN URL for an image variant.
+     *
+     * @param objectKey - Object key without extension (e.g. "avatar/image/usr-1/abc")
+     * @param options - Image variant options including extension, dimensions, resize type, and optional quality
+     * @returns Full CDN URL for the image variant
+     *
+     * @example
+     * media.getImageUrl('avatar/image/usr-1/abc', {
+     *   extension: 'webp', width: 200, height: 200, resizeType: 'fit', quality: 80,
+     * });
+     * // → "https://cdn.example.com/avatar/image/usr-1/abc-200x200-fit-q80.webp"
+     */
+    getImageUrl(objectKey: string, options: ImageUrlOptions): string;
+    /**
+     * 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: string): string;
+    /**
+     * 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: string): string;
+    /**
+     * Build a deterministic variant string from image options.
+     *
+     * Format: {width}x{height}-{resizeType}[-q{quality}]
+     */
+    private buildVariantString;
+    private validateImageOptions;
+}
-export { IMAGE_FORMAT, IMAGE_RESIZE_TYPE, type ImageFormat, type ImageResizeType, type ImageVariantOptions, MEDIA_DEFAULTS, MEDIA_PURPOSE, MEDIA_STATUS, MEDIA_TYPE, type MediaPurpose, type MediaStatus, type MediaType, type ParsedMediaUrl, R2_PATH, buildImageVariantUrl, buildVariantString, buildVideoHlsUrl, buildVideoThumbnailUrl, parseMediaUrl };
+export { IMAGE_FORMAT, IMAGE_RESIZE_TYPE, type ImageFormat, type ImageResizeType, type ImageUrlOptions, MEDIA_DEFAULTS, MEDIA_PURPOSE, MEDIA_STATUS, MEDIA_TYPE, R2_PATH, SprouxMedia, type SprouxMediaConfig };

package/dist/index.d.ts CHANGED Viewed

@@ -14,115 +14,99 @@ declare const MEDIA_STATUS: {
     readonly READY: "ready";
     readonly ERROR: "error";
 };
-declare const IMAGE_FORMAT: {
-    readonly WEBP: "webp";
-    readonly AVIF: "avif";
-    readonly JPEG: "jpeg";
-    readonly PNG: "png";
-    readonly JPG: "jpg";
-};
-declare const IMAGE_RESIZE_TYPE: {
-    readonly FIT: "fit";
-    readonly FILL: "fill";
-    readonly AUTO: "auto";
-};
+declare enum IMAGE_FORMAT {
+    WEBP = "webp",
+    AVIF = "avif",
+    JPEG = "jpeg",
+    PNG = "png",
+    GIF = "gif",
+    ICO = "ico",
+    SVG = "svg",
+    JPG = "jpg"
+}
+declare enum IMAGE_RESIZE_TYPE {
+    FIT = "fit",
+    FILL = "fill",
+    FORCE = "force",
+    FILL_DOWN = "fill-down",
+    AUTO = "auto"
+}
 declare const R2_PATH: {
     readonly HLS_PLAYLIST: "playlist.m3u8";
     readonly THUMBNAIL: "thumbnail.webp";
 };
 declare const MEDIA_DEFAULTS: {
-    readonly IMAGE_FORMAT: "webp";
+    readonly IMAGE_FORMAT: IMAGE_FORMAT.WEBP;
 };
-type MediaType = (typeof MEDIA_TYPE)[keyof typeof MEDIA_TYPE];
-type MediaPurpose = (typeof MEDIA_PURPOSE)[keyof typeof MEDIA_PURPOSE];
-type MediaStatus = (typeof MEDIA_STATUS)[keyof typeof MEDIA_STATUS];
-type ImageFormat = (typeof IMAGE_FORMAT)[keyof typeof IMAGE_FORMAT];
-type ImageResizeType = (typeof IMAGE_RESIZE_TYPE)[keyof typeof IMAGE_RESIZE_TYPE];
-interface ParsedMediaUrl {
-    /** Full original URL */
-    originalUrl: string;
-    /** CDN base including protocol and host */
-    cdnBase: string;
-    /** Object key without CDN base */
-    objectKey: string;
-    /** Purpose segment: avatar, hero, gallery */
-    purpose: MediaPurpose;
-    /** Type segment: image, video */
-    type: MediaType;
-    /** User ID segment */
-    userId: string;
-    /** File name without extension */
-    name: string;
-    /** File extension without dot */
-    extension: string;
+type ImageFormat = `${IMAGE_FORMAT}`;
+type ImageResizeType = `${IMAGE_RESIZE_TYPE}`;
+interface SprouxMediaConfig {
+    /** CDN base URL including protocol and host (e.g. "https://cdn.example.com") */
+    cdnUrl: string;
 }
-interface ImageVariantOptions {
+interface ImageUrlOptions {
+    /** Output format extension (e.g. "webp", "avif") */
+    extension: ImageFormat;
     /** Target width in pixels (1-4096) */
     width: number;
     /** Target height in pixels (1-4096) */
     height: number;
     /** Resize type: fit, fill, auto */
     resizeType: ImageResizeType;
-    /** Output format (default: webp) */
-    format?: ImageFormat;
-    /** Quality 1-100 */
+    /** Quality 1-100 (optional) */
     quality?: number;
 }
-/**
- * Parse a full media URL into structured components.
- *
- * Expected URL pattern:
- *   {cdnBase}/{purpose}/{type}/{userId}/{name}.{extension}
- *
- * Example:
- *   https://cdn.example.com/avatar/image/usr-1/abc.jpg
- *   → { cdnBase: "https://cdn.example.com", purpose: "avatar", type: "image", userId: "usr-1", name: "abc", extension: "jpg" }
- */
-declare function parseMediaUrl(originalUrl: string): ParsedMediaUrl;
-/**
- * Build a deterministic variant string from image variant options.
- *
- * Format: {width}x{height}-{resizeType}[-q{quality}]
- *
- * Examples:
- *   { width: 200, height: 200, resizeType: 'fit' }            → "200x200-fit"
- *   { width: 200, height: 200, resizeType: 'fit', quality: 80 } → "200x200-fit-q80"
- */
-declare function buildVariantString(options: ImageVariantOptions): string;
-/**
- * Build a full CDN URL for an image variant.
- *
- * Takes an original image URL and variant options, returns the CDN URL
- * for that specific variant.
- *
- * Example:
- *   buildImageVariantUrl("https://cdn.example.com/avatar/image/usr-1/abc.jpg", {
- *     width: 200, height: 200, resizeType: 'fit', quality: 80
- *   })
- *   → "https://cdn.example.com/avatar/image/usr-1/abc-200x200-fit-q80.webp"
- */
-declare function buildImageVariantUrl(originalUrl: string, options: ImageVariantOptions): string;
-/**
- * Build HLS playlist URL from an original video URL.
- *
- * Example:
- *   buildVideoHlsUrl("https://cdn.example.com/gallery/video/usr-1/xyz.mp4")
- *   → "https://cdn.example.com/gallery/video/usr-1/xyz/playlist.m3u8"
- */
-declare function buildVideoHlsUrl(originalUrl: string): string;
-/**
- * Build thumbnail URL from an original video URL.
- *
- * Example:
- *   buildVideoThumbnailUrl("https://cdn.example.com/gallery/video/usr-1/xyz.mp4")
- *   → "https://cdn.example.com/gallery/video/usr-1/xyz/thumbnail.webp"
- */
-declare function buildVideoThumbnailUrl(originalUrl: string): string;
+declare class SprouxMedia {
+    private static instance;
+    private readonly cdnUrl;
+    private constructor();
+    /**
+     * Initialize the singleton with CDN configuration.
+     * Returns the singleton instance.
+     */
+    static init(config: SprouxMediaConfig): SprouxMedia;
+    /**
+     * Returns the existing singleton instance.
+     * Throws if `init()` has not been called.
+     */
+    static getInstance(): SprouxMedia;
+    /**
+     * Build a CDN URL for an image variant.
+     *
+     * @param objectKey - Object key without extension (e.g. "avatar/image/usr-1/abc")
+     * @param options - Image variant options including extension, dimensions, resize type, and optional quality
+     * @returns Full CDN URL for the image variant
+     *
+     * @example
+     * media.getImageUrl('avatar/image/usr-1/abc', {
+     *   extension: 'webp', width: 200, height: 200, resizeType: 'fit', quality: 80,
+     * });
+     * // → "https://cdn.example.com/avatar/image/usr-1/abc-200x200-fit-q80.webp"
+     */
+    getImageUrl(objectKey: string, options: ImageUrlOptions): string;
+    /**
+     * 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: string): string;
+    /**
+     * 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: string): string;
+    /**
+     * Build a deterministic variant string from image options.
+     *
+     * Format: {width}x{height}-{resizeType}[-q{quality}]
+     */
+    private buildVariantString;
+    private validateImageOptions;
+}
-export { IMAGE_FORMAT, IMAGE_RESIZE_TYPE, type ImageFormat, type ImageResizeType, type ImageVariantOptions, MEDIA_DEFAULTS, MEDIA_PURPOSE, MEDIA_STATUS, MEDIA_TYPE, type MediaPurpose, type MediaStatus, type MediaType, type ParsedMediaUrl, R2_PATH, buildImageVariantUrl, buildVariantString, buildVideoHlsUrl, buildVideoThumbnailUrl, parseMediaUrl };
+export { IMAGE_FORMAT, IMAGE_RESIZE_TYPE, type ImageFormat, type ImageResizeType, type ImageUrlOptions, MEDIA_DEFAULTS, MEDIA_PURPOSE, MEDIA_STATUS, MEDIA_TYPE, R2_PATH, SprouxMedia, type SprouxMediaConfig };

package/dist/index.js CHANGED Viewed

@@ -15,136 +15,126 @@ 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(", ")}`
-    );
+// src/sproux-media.ts
+var SprouxMedia = class _SprouxMedia {
+  static instance = null;
+  cdnUrl;
+  constructor(config) {
+    this.cdnUrl = config.cdnUrl.replace(/\/+$/, "");
   }
-  if (!userId) {
-    throw new Error("Missing userId segment in media URL");
+  /**
+   * 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);
   }
-  if (!filename) {
-    throw new Error("Missing filename segment in media URL");
+  /**
+   * 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;
   }
-  const dotIndex = filename.lastIndexOf(".");
-  if (dotIndex <= 0) {
-    throw new Error(`Invalid filename: "${filename}". Expected format: "name.extension"`);
+  /**
+   * Build a CDN URL for an image variant.
+   *
+   * @param objectKey - Object key without extension (e.g. "avatar/image/usr-1/abc")
+   * @param options - Image variant options including extension, dimensions, resize type, and optional quality
+   * @returns Full CDN URL for the image variant
+   *
+   * @example
+   * media.getImageUrl('avatar/image/usr-1/abc', {
+   *   extension: 'webp', width: 200, height: 200, resizeType: 'fit', quality: 80,
+   * });
+   * // → "https://cdn.example.com/avatar/image/usr-1/abc-200x200-fit-q80.webp"
+   */
+  getImageUrl(objectKey, options) {
+    this.validateImageOptions(options);
+    const variant = this.buildVariantString(options);
+    return `${this.cdnUrl}/${objectKey}-${variant}.${options.extension}`;
   }
-  const name = filename.slice(0, dotIndex);
-  const extension = filename.slice(dotIndex + 1);
-  if (!extension) {
-    throw new Error(`Missing file extension in filename: "${filename}"`);
+  /**
+   * 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}`;
   }
-  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}`);
+  /**
+   * 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}`;
   }
-  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.`);
+  /**
+   * Build a deterministic variant string from image options.
+   *
+   * Format: {width}x{height}-{resizeType}[-q{quality}]
+   */
+  buildVariantString(options) {
+    const parts = [`${options.width}x${options.height}`, options.resizeType];
+    if (options.quality != null) {
+      parts.push(`q${options.quality}`);
+    }
+    return parts.join("-");
   }
-  if (options.quality != null) {
-    if (!Number.isInteger(options.quality) || options.quality < 1 || options.quality > 100) {
+  validateImageOptions(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 quality: ${options.quality}. Must be an integer between 1 and 100.`
+        `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/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}"`);
-  }
-  return `${parsed.cdnBase}/${parsed.purpose}/video/${parsed.userId}/${parsed.name}/${R2_PATH.THUMBNAIL}`;
-}
+};
 export {
   IMAGE_FORMAT,
   IMAGE_RESIZE_TYPE,
@@ -153,10 +143,6 @@ export {
   MEDIA_STATUS,
   MEDIA_TYPE,
   R2_PATH,
-  buildImageVariantUrl,
-  buildVariantString,
-  buildVideoHlsUrl,
-  buildVideoThumbnailUrl,
-  parseMediaUrl
+  SprouxMedia
 };
 //# sourceMappingURL=index.js.map