imgix-url-builder 0.0.4 → 0.0.6

package/dist/index.js

@@ -1,173 +1,11 @@
-const camelCaseToParamCase = (input) => {
-  return input.replace(/[A-Z]/g, (match) => {
-    return `-${match.toLowerCase()}`;
-  });
-};
-const buildURL = (url, params) => {
-  const instance = new URL(url);
-  for (const camelCasedParamKey in params) {
-    const paramKey = camelCaseToParamCase(camelCasedParamKey);
-    const paramValue = params[camelCasedParamKey];
-    if (paramValue === void 0) {
-      instance.searchParams.delete(paramKey);
-    } else if (Array.isArray(paramValue)) {
-      instance.searchParams.set(paramKey, paramValue.join(","));
-    } else {
-      instance.searchParams.set(paramKey, `${paramValue}`);
-    }
-  }
-  const s = instance.searchParams.get("s");
-  if (s) {
-    instance.searchParams.delete("s");
-    instance.searchParams.append("s", s);
-  }
-  return instance.toString();
-};
-
-const buildPixelDensitySrcSet = (url, { pixelDensities, ...params }) => {
-  return pixelDensities.map((dpr) => {
-    return `${buildURL(url, { ...params, dpr })} ${dpr}x`;
-  }).join(", ");
-};
-
-const buildWidthSrcSet = (url, { widths, ...params }) => {
-  return widths.map((width) => {
-    return `${buildURL(url, { ...params, w: void 0, width })} ${width}w`;
-  }).join(", ");
-};
-
-class Client {
-  /**
-   * Creates a new `Client` instance for an Imgix domain.
-   *
-   * @param options - Options to instantiate a new client.
-   *
-   * @returns A `Client` instance for the given Imgix domain.
-   */
-  constructor(options) {
-    this.baseURL = options.baseURL;
-  }
-  /**
-   * Builds a URL to an Imgix image with Imgix URL API parameters for the
-   * client's base URL.
-   *
-   * @example
-   *
-   * ```ts
-   * const client = new Client({ baseURL: "https://example.imgix.net" });
-   * const url = client.buildURLForPath("/image.png", { width: 400 });
-   * // => https://example.imgix.net/image.png?width=400
-   * ```
-   *
-   * @example
-   *
-   * ```ts
-   * const client = new Client({
-   * 	baseURL: "https://example.imgix.net/folder",
-   * });
-   * const url = client.buildURLForPath("./image.png", { width: 400 });
-   * // => https://example.imgix.net/folder/image.png?width=400
-   * ```
-   *
-   * @param path - Path to the image relative to the client's base URL.
-   * @param params - An object of Imgix URL API parameters.
-   *
-   * @returns The full absolute URL to the image with the given Imgix URL API
-   *   parameters applied.
-   */
-  buildURLForPath(path, params = {}) {
-    return buildURL(`${new URL(path, this.baseURL)}`, params);
-  }
-  /**
-   * Builds an `<img>` `srcset` attribute value for a given set of widths for
-   * the client's base URL. It can also optinally apply Imgix URL API parameters
-   * to the URLs.
-   *
-   * The `width` URL parameter will be applied for each `srcset` entry. If a
-   * `width` or `w` parameter is provided to the `params` parameter, it will be
-   * ignored.
-   *
-   * @example
-   *
-   * ```ts
-   * const client = new Client({ baseURL: "https://example.imgix.net" });
-   * const srcset = client.buildWidthSrcSetForPath("/image.png", {
-   * 	widths: [400, 800, 1600],
-   * });
-   * // => https://example.imgix.net/image.png?width=400 400w,
-   * //    https://example.imgix.net/image.png?width=800 800w,
-   * //    https://example.imgix.net/image.png?width=1600 1600w
-   * ```
-   *
-   * @example
-   *
-   * ```ts
-   * const client = new Client({
-   * 	baseURL: "https://example.imgix.net",
-   * });
-   * const srcset = client.buildWidthSrcSetForPath("/image.png", {
-   * 	widths: [400, 800, 1600],
-   * 	sat: -100,
-   * });
-   * // => https://example.imgix.net/image.png?width=400&sat=-100 400w,
-   * //    https://example.imgix.net/image.png?width=800&sat=-100 800w,
-   * //    https://example.imgix.net/image.png?width=1600&sat=-100 1600w
-   * ```
-   *
-   * @param path - Path to the image relative to the client's base URL.
-   * @param params - An object of Imgix URL API parameters. The `widths`
-   *   parameter defines the resulting `srcset` widths.
-   *
-   * @returns A `srcset` attribute value for `url` with the given Imgix URL API
-   *   parameters applied.
-   */
-  buildWidthSrcSetForPath(path, params) {
-    return buildWidthSrcSet(`${new URL(path, this.baseURL)}`, params);
-  }
-  /**
-   * Builds an `<img>` `srcset` attribute value for a given set of pixel
-   * densities for the client's base URL. It can also optinally apply Imgix URL
-   * API parameters to the URLs.
-   *
-   * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`
-   * parameter is provided to the `params` parameter, it will be ignored.
-   *
-   * @example
-   *
-   * ```ts
-   * const client = new Client({ baseURL: "https://example.imgix.net" });
-   * const srcset = client.buildPixelDensitySrcSetForPath("/image.png", {
-   * 	pixelDensities: [1, 2, 3],
-   * });
-   * // => https://example.imgix.net/image.png?dpr=1 1x,
-   * //    https://example.imgix.net/image.png?dpr=2 2x,
-   * //    https://example.imgix.net/image.png?dpr=3 3x
-   * ```
-   *
-   * @example
-   *
-   * ```ts
-   * const client = new Client({ baseURL: "https://example.imgix.net" });
-   * const srcset = client.buildPixelDensitySrcSetForPath("/image.png", {
-   * 	pixelDensities: [1, 2, 3],
-   * 	sat: -100,
-   * });
-   * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,
-   * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,
-   * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x
-   * ```
-   *
-   * @param path - Path to the image relative to the client's base URL.
-   * @param params - An object of Imgix URL API parameters. The `pixelDensities`
-   *   parameter defines the resulting `srcset` widths.
-   *
-   * @returns A `srcset` attribute value for `url` with the given Imgix URL API
-   *   parameters applied.
-   */
-  buildPixelDensitySrcSetForPath(path, params) {
-    return buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);
-  }
-}
-
-export { Client, buildPixelDensitySrcSet, buildURL, buildWidthSrcSet };
-//# sourceMappingURL=index.mjs.map
+import { Client } from "./Client.js";
+import { buildURL } from "./buildURL.js";
+import { buildWidthSrcSet } from "./buildWidthSrcSet.js";
+import { buildPixelDensitySrcSet } from "./buildPixelDensitySrcSet.js";
+export {
+  Client,
+  buildPixelDensitySrcSet,
+  buildURL,
+  buildWidthSrcSet
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/node/{index.cjs → SecureClient.cjs}

@@ -1,78 +1,15 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-const crypto = require('crypto');
-
-const camelCaseToParamCase = (input) => {
-  return input.replace(/[A-Z]/g, (match) => {
-    return `-${match.toLowerCase()}`;
-  });
-};
-const buildURL = (url, params) => {
-  const instance = new URL(url);
-  for (const camelCasedParamKey in params) {
-    const paramKey = camelCaseToParamCase(camelCasedParamKey);
-    const paramValue = params[camelCasedParamKey];
-    if (paramValue === void 0) {
-      instance.searchParams.delete(paramKey);
-    } else if (Array.isArray(paramValue)) {
-      instance.searchParams.set(paramKey, paramValue.join(","));
-    } else {
-      instance.searchParams.set(paramKey, `${paramValue}`);
-    }
-  }
-  const s = instance.searchParams.get("s");
-  if (s) {
-    instance.searchParams.delete("s");
-    instance.searchParams.append("s", s);
-  }
-  return instance.toString();
-};
-
-const buildPixelDensitySrcSet = (url, { pixelDensities, ...params }) => {
-  return pixelDensities.map((dpr) => {
-    return `${buildURL(url, { ...params, dpr })} ${dpr}x`;
-  }).join(", ");
-};
-
-const signURL = (url, secureURLToken) => {
-  const instance = new URL(url);
-  instance.searchParams.delete("s");
-  const signature = crypto.createHash("md5").update(secureURLToken + instance.pathname + instance.search).digest("hex");
-  instance.searchParams.append("s", signature);
-  return instance.toString();
-};
-
-const buildSignedURL = (url, secureURLToken, params) => {
-  return signURL(buildURL(url, params), secureURLToken);
-};
-
-const buildSignedPixelDensitySrcSet = (url, secureURLToken, { pixelDensities, ...params }) => {
-  return pixelDensities.map((dpr) => {
-    return `${buildSignedURL(url, secureURLToken, {
-      ...params,
-      dpr
-    })} ${dpr}x`;
-  }).join(", ");
-};
-
-const buildSignedWidthSrcSet = (url, secureURLToken, { widths, ...params }) => {
-  return widths.map((width) => {
-    return `${buildSignedURL(url, secureURLToken, {
-      ...params,
-      w: void 0,
-      width
-    })} ${width}w`;
-  }).join(", ");
-};
-
-const buildWidthSrcSet = (url, { widths, ...params }) => {
-  return widths.map((width) => {
-    return `${buildURL(url, { ...params, w: void 0, width })} ${width}w`;
-  }).join(", ");
-};
-
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const buildPixelDensitySrcSet = require("../buildPixelDensitySrcSet.cjs");
+const buildSignedPixelDensitySrcSet = require("./buildSignedPixelDensitySrcSet.cjs");
+const buildSignedURL = require("./buildSignedURL.cjs");
+const buildSignedWidthSrcSet = require("./buildSignedWidthSrcSet.cjs");
+const buildURL = require("../buildURL.cjs");
+const buildWidthSrcSet = require("../buildWidthSrcSet.cjs");
+const signURL = require("./signURL.cjs");
 class SecureClient {
   /**
    * Creates a new `SecureClient` instance for an Imgix domain.
@@ -82,6 +19,15 @@ class SecureClient {
    * @returns A `SecureClient` instance for the given Imgix domain.
    */
   constructor(options) {
+    /**
+     * The base URL used to construct image URLs from a path. The base URL must
+     * include the protocol, domain, and optionally a path.
+     */
+    __publicField(this, "baseURL");
+    /**
+     * The secret secure URL token for the configured Imgix domain.
+     */
+    __publicField(this, "secureURLToken");
     this.baseURL = options.baseURL;
     this.secureURLToken = options.secureURLToken;
   }
@@ -185,7 +131,7 @@ class SecureClient {
    *   parameters applied.
    */
   buildURLForPath(path, params = {}) {
-    return buildURL(`${new URL(path, this.baseURL)}`, params);
+    return buildURL.buildURL(`${new URL(path, this.baseURL)}`, params);
   }
   /**
    * Builds a URL to an Imgix image with Imgix URL API parameters. The URL is
@@ -228,7 +174,7 @@ class SecureClient {
    * @see Details on securing Imgix images: https://docs.imgix.com/setup/securing-images
    */
   buildSignedURL(url, params = {}) {
-    return buildSignedURL(url, this.secureURLToken, params);
+    return buildSignedURL.buildSignedURL(url, this.secureURLToken, params);
   }
   /**
    * Signs an Imgix image URL by appending a signature to the URL parameters.
@@ -251,7 +197,7 @@ class SecureClient {
    * @see Details on securing Imgix images: https://docs.imgix.com/setup/securing-images
    */
   signURL(url) {
-    return signURL(url, this.secureURLToken);
+    return signURL.signURL(url, this.secureURLToken);
   }
   /**
    * Builds an `<img>` `srcset` attribute value for a given set of widths. It
@@ -298,7 +244,7 @@ class SecureClient {
    *   parameters applied.
    */
   buildSignedWidthSrcSet(url, params) {
-    return buildSignedWidthSrcSet(url, this.secureURLToken, params);
+    return buildSignedWidthSrcSet.buildSignedWidthSrcSet(url, this.secureURLToken, params);
   }
   /**
    * Builds an `<img>` `srcset` attribute value for a given set of widths for
@@ -351,7 +297,7 @@ class SecureClient {
    *   parameters applied.
    */
   buildWidthSrcSetForPath(path, params) {
-    return buildWidthSrcSet(`${new URL(path, this.baseURL)}`, params);
+    return buildWidthSrcSet.buildWidthSrcSet(`${new URL(path, this.baseURL)}`, params);
   }
   /**
    * Builds an `<img>` `srcset` attribute value for a given set of widths for
@@ -403,10 +349,7 @@ class SecureClient {
    *   parameters applied.
    */
   buildSignedWidthSrcSetForPath(path, params) {
-    return this.buildSignedWidthSrcSet(
-      `${new URL(path, this.baseURL)}`,
-      params
-    );
+    return this.buildSignedWidthSrcSet(`${new URL(path, this.baseURL)}`, params);
   }
   /**
    * Builds an `<img>` `srcset` attribute value for a given set of pixel
@@ -453,7 +396,7 @@ class SecureClient {
    *   parameters applied.
    */
   buildSignedPixelDensitySrcSet(url, params) {
-    return buildSignedPixelDensitySrcSet(url, this.secureURLToken, params);
+    return buildSignedPixelDensitySrcSet.buildSignedPixelDensitySrcSet(url, this.secureURLToken, params);
   }
   /**
    * Builds an `<img>` `srcset` attribute value for a given set of pixel
@@ -505,7 +448,7 @@ class SecureClient {
    *   parameters applied.
    */
   buildPixelDensitySrcSetForPath(path, params) {
-    return buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);
+    return buildPixelDensitySrcSet.buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);
   }
   /**
    * Builds an `<img>` `srcset` attribute value for a given set of pixel
@@ -560,18 +503,8 @@ class SecureClient {
    *   parameters applied.
    */
   buildSignedPixelDensitySrcSetForPath(path, params) {
-    return buildSignedPixelDensitySrcSet(
-      `${new URL(path, this.baseURL)}`,
-      this.secureURLToken,
-      params
-    );
+    return buildSignedPixelDensitySrcSet.buildSignedPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, this.secureURLToken, params);
   }
 }
-
 exports.SecureClient = SecureClient;
-exports.buildSignedPixelDensitySrcSet = buildSignedPixelDensitySrcSet;
-exports.buildSignedURL = buildSignedURL;
-exports.buildSignedWidthSrcSet = buildSignedWidthSrcSet;
-exports.buildURL = buildURL;
-exports.signURL = signURL;
-//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=SecureClient.cjs.map

package/dist/node/SecureClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecureClient.cjs","sources":["../../../src/node/SecureClient.ts"],"sourcesContent":["import type { BuildPixelDensitySrcSetParams } from \"../buildPixelDensitySrcSet\";\nimport type { BuildWidthSrcSetParams } from \"../buildWidthSrcSet\";\nimport type { ImgixURLParams } from \"../types.generated\";\nimport { buildPixelDensitySrcSet } from \"../buildPixelDensitySrcSet\";\nimport { buildSignedPixelDensitySrcSet } from \"./buildSignedPixelDensitySrcSet\";\nimport { buildSignedURL } from \"./buildSignedURL\";\nimport { buildSignedWidthSrcSet } from \"./buildSignedWidthSrcSet\";\nimport { buildURL } from \"../buildURL\";\nimport { buildWidthSrcSet } from \"../buildWidthSrcSet\";\nimport { signURL } from \"./signURL\";\n\n/**\n * Options to instantiate a new secure client.\n */\nexport type SecureClientOptions = {\n\t/**\n\t * The base URL used to construct image URLs from a path. The base URL must\n\t * include the protocol, domain, and optionally a path.\n\t *\n\t * @example `https://example.imgix.net`\n\t *\n\t * @example `https://example.imgix.net/folder`\n\t */\n\tbaseURL: string;\n\n\t/**\n\t * The secret secure URL token for the configured Imgix domain.\n\t *\n\t * @see How to get a token: https://docs.imgix.com/setup/securing-images\n\t */\n\tsecureURLToken: string;\n};\n\n/**\n * An Imgix Rendering API client with automatic URL signing. A client is paired\n * to a single Imgix domain and secure URL token.\n *\n * **Important**: This client should only be used in a trusted environment and\n * never in a browser. The `secureURLToken` parameter is a secret and should not\n * be exposed to the public.\n */\nexport class SecureClient {\n\t/**\n\t * The base URL used to construct image URLs from a path. The base URL must\n\t * include the protocol, domain, and optionally a path.\n\t */\n\tbaseURL: string;\n\n\t/**\n\t * The secret secure URL token for the configured Imgix domain.\n\t */\n\tsecureURLToken: string;\n\n\t/**\n\t * Creates a new `SecureClient` instance for an Imgix domain.\n\t *\n\t * @param options - Options to instantiate a new client.\n\t *\n\t * @returns A `SecureClient` instance for the given Imgix domain.\n\t */\n\tconstructor(options: SecureClientOptions) {\n\t\tthis.baseURL = options.baseURL;\n\t\tthis.secureURLToken = options.secureURLToken;\n\t}\n\n\t/**\n\t * Builds a Web Proxy URL that proxies a non-Imgix URL to Imgix. The client's\n\t * Imgix domain must be configured as a Web Proxy source. All Web Proxy URLs\n\t * will be signed automatically.\n\t *\n\t * **Important**: The given URL must not be URI encoded. If it is, decode it\n\t * before passing it to `buildWebProxyURL()`.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const url = client.buildWebProxyURL(\"https://www.this.com/pic.jpg\", {\n\t * \twidth: 400,\n\t * });\n\t * // => https://example.imgix.net/https%3A%2F%2Fwww.this.com%2Fpic.jpg?width=400&s=def3e221c3f4c4debda091b8e49420ea\n\t * ```\n\t *\n\t * @param url - Full absolute URL to the source image to proxy.\n\t * @param params - An object of Imgix URL API parameters.\n\t *\n\t * @returns An Imgix url proxying `url` to the client's Imgix domain.\n\t */\n\tbuildWebProxyURL(url: string, params: ImgixURLParams = {}): string {\n\t\treturn this.buildSignedURLForPath(encodeURIComponent(url), params);\n\t}\n\n\t/**\n\t * Builds a URL to an Imgix image with Imgix URL API parameters for the\n\t * client's base URL.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const url = client.buildURLForPath(\"/image.png\", { width: 400 });\n\t * // => https://example.imgix.net/image.png?width=400&s=def3e221c3f4c4debda091b8e49420ea\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net/folder\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const url = client.buildURLForPath(\"./image.png\", { width: 400 });\n\t * // => https://example.imgix.net/folder/image.png?width=400&s=f12c7c39333410c10c2930b57116a943\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters.\n\t *\n\t * @returns The full absolute URL to the image with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildSignedURLForPath(path: string, params: ImgixURLParams = {}): string {\n\t\treturn this.signURL(this.buildURLForPath(path, params));\n\t}\n\n\t/**\n\t * Builds a URL to an Imgix image with Imgix URL API parameters for the\n\t * client's base URL.\n\t *\n\t * Note: The returned URL is not signed. See `buildSignedURL` if a signature\n\t * is required.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const url = client.buildURLForPath(\"/image.png\", { width: 400 });\n\t * // => https://example.imgix.net/image.png?width=400\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net/folder\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const url = client.buildURLForPath(\"./image.png\", { width: 400 });\n\t * // => https://example.imgix.net/folder/image.png?width=400\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters.\n\t *\n\t * @returns The full absolute URL to the image with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildURLForPath(path: string, params: ImgixURLParams = {}): string {\n\t\treturn buildURL(`${new URL(path, this.baseURL)}`, params);\n\t}\n\n\t/**\n\t * Builds a URL to an Imgix image with Imgix URL API parameters. The URL is\n\t * signed by appending a signature to the URL parameters. This locks the URL\n\t * and its parameters to the signature to prevent URL tampering.\n\t *\n\t * The given URL must be a full absolute URL containing the protocol and\n\t * domain.\n\t *\n\t * URL parameters already applied to the image will be retained. To remove\n\t * existing parameters, set the parameter to `undefined` in the `params`\n\t * argument.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const url = client.buildSignedURL(\n\t * \t\"https://example.imgix.net/image.png\",\n\t * \t{ width: 400 },\n\t * );\n\t * // => https://example.imgix.net/image.png?width=400&s=def3e221c3f4c4debda091b8e49420ea\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const url = client.buildSignedURL(\n\t * \t\"https://example.imgix.net/image.png?width=400\",\n\t * \t{ height: 300 },\n\t * );\n\t * // => https://example.imgix.net/image.png?width=400&height=300&s=f12c7c39333410c10c2930b57116a943\n\t * ```\n\t *\n\t * @param url - Full absolute URL to the Imgix image.\n\t * @param params - An object of Imgix URL API parameters.\n\t *\n\t * @returns `url` with the given Imgix URL API parameters applied.\n\t *\n\t * @see Imgix URL API reference: https://docs.imgix.com/apis/rendering\n\t * @see Details on securing Imgix images: https://docs.imgix.com/setup/securing-images\n\t */\n\tbuildSignedURL(url: string, params: ImgixURLParams = {}): string {\n\t\treturn buildSignedURL(url, this.secureURLToken, params);\n\t}\n\n\t/**\n\t * Signs an Imgix image URL by appending a signature to the URL parameters.\n\t * This locks the URL and its parameters to the signature to prevent URL\n\t * tampering.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const url = client.signURL(\n\t * \t\"https://example.imgix.net/image.png?width=400\",\n\t * );\n\t * // => https://example.imgix.net/image.png?width=400&s=def3e221c3f4c4debda091b8e49420ea\n\t * ```\n\t *\n\t * @param url - Full absolute URL to the Imgix image to sign.\n\t *\n\t * @returns `url` with a signature appended via an `s` URL parameter.\n\t *\n\t * @see Details on securing Imgix images: https://docs.imgix.com/setup/securing-images\n\t */\n\tsignURL(url: string): string {\n\t\treturn signURL(url, this.secureURLToken);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of widths. It\n\t * can also optinally apply Imgix URL API parameters to the URLs. The URLs are\n\t * signed by appending a signature to their URL parameters. This locks the\n\t * URLs and their parameters to the signature to prevent URL tampering.\n\t *\n\t * The `width` URL parameter will be applied for each `srcset` entry. If a\n\t * `width` or `w` parameter is provided to the `params` parameter, it will be\n\t * ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const srcset = client.buildSignedWidthSrcSet(\n\t * \t\"https://example.imgix.net/image.png\",\n\t * \t{ widths: [400, 800, 1600] },\n\t * );\n\t * // => https://example.imgix.net/image.png?width=400&s=def3e221c3f4c4debda091b8e49420ea 400w,\n\t * //    https://example.imgix.net/image.png?width=800&s=f12c7c39333410c10c2930b57116a943 800w,\n\t * //    https://example.imgix.net/image.png?width=1600&s=3a975b5087ab7ad2ab91fe66072fd628 1600w\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const srcset = client.buildSignedWidthSrcSet(\n\t * \t\"https://example.imgix.net/image.png\",\n\t * \t{\n\t * \t\twidths: [400, 800, 1600],\n\t * \t\tsat: -100,\n\t * \t},\n\t * );\n\t * // => https://example.imgix.net/image.png?width=400&sat=-100&s=def3e221c3f4c4debda091b8e49420ea 400w,\n\t * //    https://example.imgix.net/image.png?width=800&sat=-100&s=f12c7c39333410c10c2930b57116a943 800w,\n\t * //    https://example.imgix.net/image.png?width=1600&sat=-100&s=3a975b5087ab7ad2ab91fe66072fd628 1600w\n\t * ```\n\t *\n\t * @param url - Full absolute URL to the Imgix image.\n\t * @param params - An object of Imgix URL API parameters. The `widths`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildSignedWidthSrcSet(url: string, params: BuildWidthSrcSetParams): string {\n\t\treturn buildSignedWidthSrcSet(url, this.secureURLToken, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of widths for\n\t * the client's base URL. It can also optinally apply Imgix URL API parameters\n\t * to the URLs.\n\t *\n\t * The `width` URL parameter will be applied for each `srcset` entry. If a\n\t * `width` or `w` parameter is provided to the `params` parameter, it will be\n\t * ignored.\n\t *\n\t * Note: The returned URLs are not signed. See `buildSignedWidthSrcSet` if\n\t * signatures are required.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400 400w,\n\t * //    https://example.imgix.net/image.png?width=800 800w,\n\t * //    https://example.imgix.net/image.png?width=1600 1600w\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * \tsat: -100,\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400&sat=-100 400w,\n\t * //    https://example.imgix.net/image.png?width=800&sat=-100 800w,\n\t * //    https://example.imgix.net/image.png?width=1600&sat=-100 1600w\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `widths`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildWidthSrcSetForPath(\n\t\tpath: string,\n\t\tparams: BuildWidthSrcSetParams,\n\t): string {\n\t\treturn buildWidthSrcSet(`${new URL(path, this.baseURL)}`, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of widths for\n\t * the client's base URL. It can also optinally apply Imgix URL API parameters\n\t * to the URLs. The URLs are signed by appending a signature to their URL\n\t * parameters. This locks the URLs and their parameters to the signature to\n\t * prevent URL tampering.\n\t *\n\t * The `width` URL parameter will be applied for each `srcset` entry. If a\n\t * `width` or `w` parameter is provided to the `params` parameter, it will be\n\t * ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildSignedWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400&s=def3e221c3f4c4debda091b8e49420ea 400w,\n\t * //    https://example.imgix.net/image.png?width=800&s=f12c7c39333410c10c2930b57116a943 800w,\n\t * //    https://example.imgix.net/image.png?width=1600&s=3a975b5087ab7ad2ab91fe66072fd628 1600w\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildSignedWidthSrcSetForPath(\"/image.png\", {\n\t * \twidths: [400, 800, 1600],\n\t * \tsat: -100,\n\t * });\n\t * // => https://example.imgix.net/image.png?width=400&sat=-100&s=def3e221c3f4c4debda091b8e49420ea 400w,\n\t * //    https://example.imgix.net/image.png?width=800&sat=-100&s=f12c7c39333410c10c2930b57116a943 800w,\n\t * //    https://example.imgix.net/image.png?width=1600&sat=-100&s=3a975b5087ab7ad2ab91fe66072fd628 1600w\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `widths`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildSignedWidthSrcSetForPath(\n\t\tpath: string,\n\t\tparams: BuildWidthSrcSetParams,\n\t): string {\n\t\treturn this.buildSignedWidthSrcSet(\n\t\t\t`${new URL(path, this.baseURL)}`,\n\t\t\tparams,\n\t\t);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of pixel\n\t * densities. It can also optinally apply Imgix URL API parameters to the\n\t * URLs. The URLs are signed by appending a signature to their URL parameters.\n\t * This locks the URLs and their parameters to the signature to prevent URL\n\t * tampering.\n\t *\n\t * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`\n\t * parameter is provided to the `params` parameter, it will be ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const srcset = client.buildSignedPixelDensitySrcSet(\n\t * \t\"https://example.imgix.net/image.png\",\n\t * \t{ pixelDensities: [1, 2, 3] },\n\t * );\n\t * // => https://example.imgix.net/image.png?dpr=1&s=def3e221c3f4c4debda091b8e49420ea 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2&s=f12c7c39333410c10c2930b57116a943 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3&s=3a975b5087ab7ad2ab91fe66072fd628 3x\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const srcset = client.buildSignedPixelDensitySrcSet(\n\t * \t\"https://example.imgix.net/image.png\",\n\t * \t{\n\t * \t\tpixelDensities: [1, 2, 3],\n\t * \t\tsat: -100,\n\t * \t},\n\t * );\n\t * // => https://example.imgix.net/image.png?dpr=1&sat=-100&s=def3e221c3f4c4debda091b8e49420ea 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2&sat=-100&s=f12c7c39333410c10c2930b57116a943 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3&sat=-100&s=3a975b5087ab7ad2ab91fe66072fd628 3x\n\t * ```\n\t *\n\t * @param url - Full absolute URL to the Imgix image.\n\t * @param params - An object of Imgix URL API parameters. The `pixelDensities`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildSignedPixelDensitySrcSet(\n\t\turl: string,\n\t\tparams: BuildPixelDensitySrcSetParams,\n\t): string {\n\t\treturn buildSignedPixelDensitySrcSet(url, this.secureURLToken, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of pixel\n\t * densities for the client's base URL. It can also optinally apply Imgix URL\n\t * API parameters to the URLs.\n\t *\n\t * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`\n\t * parameter is provided to the `params` parameter, it will be ignored.\n\t *\n\t * Note: The returned URLs are not signed. See `buildSignedPixelDensitySrcSet`\n\t * if signatures are required.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildPixelDensitySrcSetForPath(\"/image.png\", {\n\t * \tpixelDensities: [1, 2, 3],\n\t * });\n\t * // => https://example.imgix.net/image.png?dpr=1 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3 3x\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildPixelDensitySrcSetForPath(\"/image.png\", {\n\t * \tpixelDensities: [1, 2, 3],\n\t * \tsat: -100,\n\t * });\n\t * // => https://example.imgix.net/image.png?dpr=1&sat=-100 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2&sat=-100 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3&sat=-100 3x\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `pixelDensities`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildPixelDensitySrcSetForPath(\n\t\tpath: string,\n\t\tparams: BuildPixelDensitySrcSetParams,\n\t): string {\n\t\treturn buildPixelDensitySrcSet(`${new URL(path, this.baseURL)}`, params);\n\t}\n\n\t/**\n\t * Builds an `<img>` `srcset` attribute value for a given set of pixel\n\t * densities for the client's base URL. It can also optinally apply Imgix URL\n\t * API parameters to the URLs. The URLs are signed by appending a signature to\n\t * their URL parameters. This locks the URLs and their parameters to the\n\t * signature to prevent URL tampering.\n\t *\n\t * The `dpr` URL parameter will be applied for each `srcset` entry. If a `dpr`\n\t * parameter is provided to the `params` parameter, it will be ignored.\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildSignedPixelDensitySrcSetForPath(\n\t * \t\"/image.png\",\n\t * \t{ pixelDensities: [1, 2, 3] },\n\t * );\n\t * // => https://example.imgix.net/image.png?dpr=1&s=def3e221c3f4c4debda091b8e49420ea 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2&s=f12c7c39333410c10c2930b57116a943 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3&s=3a975b5087ab7ad2ab91fe66072fd628 3x\n\t * ```\n\t *\n\t * @example\n\t *\n\t * ```ts\n\t * const client = new SecureClient({\n\t * \tbaseURL: \"https://example.imgix.net\",\n\t * \tsecureURLToken: \"example-token\",\n\t * });\n\t * const srcset = client.buildSignedPixelDensitySrcSetForPath(\n\t * \t\"/image.png\",\n\t * \t{\n\t * \t\tpixelDensities: [1, 2, 3],\n\t * \t\tsat: -100,\n\t * \t},\n\t * );\n\t * // => https://example.imgix.net/image.png?dpr=1&sat=-100&s=def3e221c3f4c4debda091b8e49420ea 1x,\n\t * //    https://example.imgix.net/image.png?dpr=2&sat=-100&s=f12c7c39333410c10c2930b57116a943 2x,\n\t * //    https://example.imgix.net/image.png?dpr=3&sat=-100&s=3a975b5087ab7ad2ab91fe66072fd628 3x\n\t * ```\n\t *\n\t * @param path - Path to the image relative to the client's base URL.\n\t * @param params - An object of Imgix URL API parameters. The `pixelDensities`\n\t *   parameter defines the resulting `srcset` widths.\n\t *\n\t * @returns A `srcset` attribute value for `url` with the given Imgix URL API\n\t *   parameters applied.\n\t */\n\tbuildSignedPixelDensitySrcSetForPath(\n\t\tpath: string,\n\t\tparams: BuildPixelDensitySrcSetParams,\n\t): string {\n\t\treturn buildSignedPixelDensitySrcSet(\n\t\t\t`${new URL(path, this.baseURL)}`,\n\t\t\tthis.secureURLToken,\n\t\t\tparams,\n\t\t);\n\t}\n}\n"],"names":["buildURL","buildSignedURL","signURL","buildSignedWidthSrcSet","buildWidthSrcSet","buildSignedPixelDensitySrcSet","buildPixelDensitySrcSet"],"mappings":"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"}