@pixelfiddler/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PixelFiddler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,212 @@
+# @pixelfiddler/core
+
+Core utilities for building [PixelFiddler](https://pixel-fiddler.com) image transformation URLs.
+
+## Installation
+
+```bash
+npm install @pixelfiddler/core
+# or
+pnpm add @pixelfiddler/core
+# or
+yarn add @pixelfiddler/core
+```
+
+## Usage
+
+```typescript
+import { buildTransformationUrl, buildQueryParams } from '@pixelfiddler/core';
+
+// Build a complete transformation URL
+const url = buildTransformationUrl(
+  { baseUrl: 'https://cdn.pixelfiddler.com/images/photo.jpg' },
+  {
+    width: 800,
+    height: 600,
+    format: 'webp',
+    quality: 85,
+  }
+);
+// => 'https://cdn.pixelfiddler.com/images/photo.jpg?w=800&h=600&f=webp&q=85'
+
+// Or just get the query string
+const params = buildQueryParams({
+  width: 400,
+  blur: 5,
+  grayscale: true,
+});
+// => 'w=400&bl=5&gs=true'
+```
+
+## API
+
+### `buildTransformationUrl(config, options, mode?)`
+
+Builds a complete transformation URL.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `config` | `UrlBuilderConfig` | Configuration with `baseUrl` |
+| `options` | `TransformationOptions` | Transformation options |
+| `mode` | `'short' \| 'long'` | Parameter naming mode (default: `'short'`) |
+
+### `buildQueryParams(options, mode?)`
+
+Converts transformation options to a URL-encoded query string.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `options` | `TransformationOptions` | Transformation options |
+| `mode` | `'short' \| 'long'` | Parameter naming mode (default: `'short'`) |
+
+## Transformation Options
+
+### Resize
+
+```typescript
+{
+  width: 800,           // Target width (px)
+  height: 600,          // Target height (px)
+  dpr: 2,               // Device pixel ratio (1-4)
+  mode: 'FIT',          // 'FILL' | 'FIT' | 'PAD' | 'FORCE' | 'COVER'
+  background: '#ffffff' // Background color for PAD mode
+}
+```
+
+### Format & Quality
+
+```typescript
+{
+  format: 'webp',       // 'jpeg' | 'png' | 'webp' | 'avif' | 'gif' | 'auto'
+  quality: 85,          // 1-100
+  stripMetadata: true   // Remove EXIF data
+}
+```
+
+### Effects
+
+```typescript
+{
+  blur: 5,              // Gaussian blur (0-100)
+  brightness: 10,       // Brightness adjustment (0-100)
+  contrast: 20,         // Contrast adjustment (0-100)
+  saturation: 30,       // Saturation adjustment (0-100)
+  sharpen: 15,          // Sharpen intensity (0-100)
+  noise: 5,             // Add noise (0-100)
+  grayscale: true,      // Convert to grayscale
+  sepia: true,          // Apply sepia effect
+  rotate: 90            // Rotation (0 | 90 | 180 | 270)
+}
+```
+
+### Border
+
+```typescript
+{
+  border: {
+    width: 2,           // Border width (px)
+    color: '#000000',   // Border color
+    radius: 8           // Corner radius (px)
+  }
+}
+```
+
+### Crop
+
+```typescript
+{
+  crop: {
+    type: 'SIMPLE',           // 'SIMPLE' | 'OBJECT'
+    objectType: 'FACE',       // 'FACE' | 'UPPER_BODY' (for OBJECT type)
+    width: 400,
+    height: 300,
+    focus: {
+      type: 'AUTO',           // 'SPECIFIED' | 'AUTO'
+      strategy: 'SMART',      // 'CENTER' | 'SMART' | 'DETAIL'
+      position: { x: 50, y: 50 }  // For SPECIFIED type
+    },
+    afterResize: true
+  }
+}
+```
+
+### Text Overlay
+
+```typescript
+{
+  text: {
+    text: 'Hello World',
+    color: '#ffffff',
+    opacity: 80,
+    size: 50,
+    font: 'Arial',
+    fontSize: 24,
+    position: 'CENTER',
+    background: '#000000',
+    backgroundOpacity: 50
+  }
+}
+```
+
+### Watermark
+
+```typescript
+{
+  watermark: {
+    name: 'logo',           // Predefined watermark name
+    opacity: 50,
+    size: 25,               // Size as percentage
+    width: 100,             // Or explicit dimensions
+    height: 50,
+    position: 'BOTTOM_RIGHT'
+  }
+}
+```
+
+### Special Options
+
+```typescript
+{
+  original: true,   // Return original image (no transformations)
+  alias: 'thumb'    // Use predefined transformation alias
+}
+```
+
+## Parameter Aliases
+
+By default, short parameter names are used for smaller URLs:
+
+| Option | Short | Long |
+|--------|-------|------|
+| width | `w` | `width` |
+| height | `h` | `height` |
+| format | `f` | `format` |
+| quality | `q` | `quality` |
+| blur | `bl` | `blur` |
+| ... | ... | ... |
+
+Use `mode: 'long'` for full parameter names:
+
+```typescript
+buildQueryParams({ width: 800 }, 'long');
+// => 'width=800'
+```
+
+## TypeScript
+
+Full TypeScript support with exported types:
+
+```typescript
+import type {
+  TransformationOptions,
+  ResizeOptions,
+  CropOptions,
+  TextOptions,
+  WatermarkOptions,
+  UrlBuilderConfig,
+} from '@pixelfiddler/core';
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,132 @@
+'use strict';
+
+// src/types.ts
+var CROP_FOCUS = {
+  SPECIFIED: "SPECIFIED",
+  AUTO: "AUTO"
+};
+var CROP_FOCUS_STRATEGY = {
+  CENTER: "CENTER",
+  SMART: "SMART",
+  DETAIL: "DETAIL"
+};
+var CROP_TYPE = {
+  SIMPLE: "SIMPLE",
+  OBJECT: "OBJECT"
+};
+var CROP_OBJECT_TYPE = {
+  FACE: "FACE",
+  UPPER_BODY: "UPPER_BODY"
+};
+
+// src/utils.ts
+var normalizeHex = (value) => value.replace("#", "");
+var removeTrailingSlash = (baseUrl) => {
+  return baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+};
+var getNestedValue = (obj, path) => path.reduce(
+  (acc, key) => acc == null ? void 0 : acc[key],
+  obj
+);
+
+// src/config.ts
+var PARAMS = [
+  { path: ["width"], long: "width", short: "w" },
+  { path: ["height"], long: "height", short: "h" },
+  { path: ["dpr"], long: "dpr", short: "dpr" },
+  { path: ["mode"], long: "mode", short: "rm" },
+  {
+    path: ["background"],
+    long: "background",
+    short: "bg",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["format"], long: "format", short: "f" },
+  { path: ["quality"], long: "quality", short: "q" },
+  { path: ["stripMetadata"], long: "stripMetadata", short: "st" },
+  { path: ["blur"], long: "blur", short: "bl" },
+  { path: ["brightness"], long: "brightness", short: "br" },
+  { path: ["contrast"], long: "contrast", short: "ct" },
+  { path: ["grayscale"], long: "grayscale", short: "gs" },
+  { path: ["saturation"], long: "saturation", short: "sa" },
+  { path: ["sepia"], long: "sepia", short: "sp" },
+  { path: ["sharpen"], long: "sharpen", short: "sh" },
+  { path: ["noise"], long: "noise", short: "ns" },
+  { path: ["rotate"], long: "rotate", short: "rt" },
+  { path: ["border", "width"], long: "border.width", short: "bo.w" },
+  {
+    path: ["border", "color"],
+    long: "border.color",
+    short: "bo.c",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["border", "radius"], long: "border.radius", short: "bo.r" },
+  { path: ["crop", "type"], long: "crop.type", short: "cr.t" },
+  { path: ["crop", "objectType"], long: "crop.objectType", short: "cr.o" },
+  { path: ["crop", "focus", "position", "x"], long: "crop.x", short: "cr.x" },
+  { path: ["crop", "focus", "position", "y"], long: "crop.y", short: "cr.y" },
+  { path: ["crop", "focus", "strategy"], long: "crop", short: "cr" },
+  { path: ["crop", "width"], long: "crop.width", short: "cr.w" },
+  { path: ["crop", "height"], long: "crop.height", short: "cr.h" },
+  { path: ["crop", "afterResize"], long: "crop.afterResize", short: "cr.ar" },
+  { path: ["text", "text"], long: "text", short: "tx" },
+  {
+    path: ["text", "color"],
+    long: "text.color",
+    short: "tx.c",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["text", "opacity"], long: "text.opacity", short: "tx.o" },
+  { path: ["text", "size"], long: "text.size", short: "tx.s" },
+  { path: ["text", "font"], long: "text.font", short: "tx.f" },
+  { path: ["text", "fontSize"], long: "text.fontSize", short: "tx.fs" },
+  { path: ["text", "position"], long: "text.position", short: "tx.p" },
+  {
+    path: ["text", "background"],
+    long: "text.background",
+    short: "tx.bg",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["text", "backgroundOpacity"], long: "text.backgroundOpacity", short: "tx.bg.o" },
+  { path: ["watermark", "name"], long: "watermark", short: "wm" },
+  { path: ["watermark", "opacity"], long: "watermark.opacity", short: "wm.o" },
+  { path: ["watermark", "size"], long: "watermark.size", short: "wm.s" },
+  { path: ["watermark", "width"], long: "watermark.width", short: "wm.w" },
+  { path: ["watermark", "height"], long: "watermark.height", short: "wm.h" },
+  { path: ["watermark", "position"], long: "watermark.position", short: "wm.p" }
+];
+
+// src/url-builder.ts
+var buildQueryParams = (options, mode = "short") => {
+  const params = [];
+  for (const spec of PARAMS) {
+    const value = getNestedValue(options, spec.path);
+    if (value == null) continue;
+    const name = mode === "short" && spec.short ? spec.short : spec.long;
+    let normalized = value;
+    if ("normalize" in spec) {
+      normalized = spec.normalize(value);
+    }
+    params.push([name, String(normalized)]);
+  }
+  return new URLSearchParams(
+    params.map(([k, v]) => [k, v])
+  ).toString();
+};
+var buildTransformationUrl = (config, options, mode = "short") => {
+  if (options.original) {
+    return `${config.baseUrl}?original`;
+  }
+  const query = buildQueryParams(options, mode);
+  const baseUrl = removeTrailingSlash(config.baseUrl);
+  return `${baseUrl}?${query}`;
+};
+
+exports.CROP_FOCUS = CROP_FOCUS;
+exports.CROP_FOCUS_STRATEGY = CROP_FOCUS_STRATEGY;
+exports.CROP_OBJECT_TYPE = CROP_OBJECT_TYPE;
+exports.CROP_TYPE = CROP_TYPE;
+exports.buildQueryParams = buildQueryParams;
+exports.buildTransformationUrl = buildTransformationUrl;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/utils.ts","../src/config.ts","../src/url-builder.ts"],"names":[],"mappings":";;;AAgCO,IAAM,UAAA,GAAa;AAAA,EACtB,SAAA,EAAW,WAAA;AAAA,EACX,IAAA,EAAM;AACV;AAOO,IAAM,mBAAA,GAAsB;AAAA,EAC/B,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ;AACZ;AAOO,IAAM,SAAA,GAAY;AAAA,EACrB,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ;AACZ;AAOO,IAAM,gBAAA,GAAmB;AAAA,EAC5B,IAAA,EAAM,MAAA;AAAA,EACN,UAAA,EAAY;AAChB;;;AChEO,IAAM,eAAe,CAAC,KAAA,KAAkB,KAAA,CAAM,OAAA,CAAQ,KAAK,EAAE,CAAA;AAG7D,IAAM,mBAAA,GAAsB,CAAC,OAAA,KAAoB;AACpD,EAAA,OAAO,OAAA,CAAQ,SAAS,GAAG,CAAA,GACrB,QAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GACnB,OAAA;AACV,CAAA;AAEO,IAAM,cAAA,GAAiB,CAI1B,GAAA,EACA,IAAA,KAEA,IAAA,CAAK,MAAA;AAAA,EACD,CAAC,GAAA,EAAK,GAAA,KAAS,OAAO,IAAA,GAAO,MAAA,GAAY,IAAI,GAAG,CAAA;AAAA,EAChD;AACJ,CAAA;;;ACjBG,IAAM,MAAA,GAAS;AAAA,EAClB,EAAC,MAAM,CAAC,OAAO,GAAG,IAAA,EAAM,OAAA,EAAS,OAAO,GAAA,EAAG;AAAA,EAC3C,EAAC,MAAM,CAAC,QAAQ,GAAG,IAAA,EAAM,QAAA,EAAU,OAAO,GAAA,EAAG;AAAA,EAC7C,EAAC,MAAM,CAAC,KAAK,GAAG,IAAA,EAAM,KAAA,EAAO,OAAO,KAAA,EAAK;AAAA,EACzC,EAAC,MAAM,CAAC,MAAM,GAAG,IAAA,EAAM,MAAA,EAAQ,OAAO,IAAA,EAAI;AAAA,EAC1C;AAAA,IACI,IAAA,EAAM,CAAC,YAAY,CAAA;AAAA,IACnB,IAAA,EAAM,YAAA;AAAA,IACN,KAAA,EAAO,IAAA;AAAA,IACP,SAAA,EAAW,CAAC,CAAA,KAAM,OAAO,MAAM,QAAA,GAAW,YAAA,CAAa,CAAC,CAAA,GAAI;AAAA,GAChE;AAAA,EAEA,EAAC,MAAM,CAAC,QAAQ,GAAG,IAAA,EAAM,QAAA,EAAU,OAAO,GAAA,EAAG;AAAA,EAC7C,EAAC,MAAM,CAAC,SAAS,GAAG,IAAA,EAAM,SAAA,EAAW,OAAO,GAAA,EAAG;AAAA,EAC/C,EAAC,MAAM,CAAC,eAAe,GAAG,IAAA,EAAM,eAAA,EAAiB,OAAO,IAAA,EAAI;AAAA,EAE5D,EAAC,MAAM,CAAC,MAAM,GAAG,IAAA,EAAM,MAAA,EAAQ,OAAO,IAAA,EAAI;AAAA,EAC1C,EAAC,MAAM,CAAC,YAAY,GAAG,IAAA,EAAM,YAAA,EAAc,OAAO,IAAA,EAAI;AAAA,EACtD,EAAC,MAAM,CAAC,UAAU,GAAG,IAAA,EAAM,UAAA,EAAY,OAAO,IAAA,EAAI;AAAA,EAClD,EAAC,MAAM,CAAC,WAAW,GAAG,IAAA,EAAM,WAAA,EAAa,OAAO,IAAA,EAAI;AAAA,EACpD,EAAC,MAAM,CAAC,YAAY,GAAG,IAAA,EAAM,YAAA,EAAc,OAAO,IAAA,EAAI;AAAA,EACtD,EAAC,MAAM,CAAC,OAAO,GAAG,IAAA,EAAM,OAAA,EAAS,OAAO,IAAA,EAAI;AAAA,EAC5C,EAAC,MAAM,CAAC,SAAS,GAAG,IAAA,EAAM,SAAA,EAAW,OAAO,IAAA,EAAI;AAAA,EAChD,EAAC,MAAM,CAAC,OAAO,GAAG,IAAA,EAAM,OAAA,EAAS,OAAO,IAAA,EAAI;AAAA,EAC5C,EAAC,MAAM,CAAC,QAAQ,GAAG,IAAA,EAAM,QAAA,EAAU,OAAO,IAAA,EAAI;AAAA,EAE9C,EAAC,MAAM,CAAC,QAAA,EAAU,OAAO,CAAA,EAAG,IAAA,EAAM,cAAA,EAAgB,KAAA,EAAO,MAAA,EAAM;AAAA,EAC/D;AAAA,IACI,IAAA,EAAM,CAAC,QAAA,EAAU,OAAO,CAAA;AAAA,IACxB,IAAA,EAAM,cAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,SAAA,EAAW,CAAC,CAAA,KAAM,OAAO,MAAM,QAAA,GAAW,YAAA,CAAa,CAAC,CAAA,GAAI;AAAA,GAChE;AAAA,EACA,EAAC,MAAM,CAAC,QAAA,EAAU,QAAQ,CAAA,EAAG,IAAA,EAAM,eAAA,EAAiB,KAAA,EAAO,MAAA,EAAM;AAAA,EAEjE,EAAC,MAAM,CAAC,MAAA,EAAQ,MAAM,CAAA,EAAG,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,MAAA,EAAM;AAAA,EACzD,EAAC,MAAM,CAAC,MAAA,EAAQ,YAAY,CAAA,EAAG,IAAA,EAAM,iBAAA,EAAmB,KAAA,EAAO,MAAA,EAAM;AAAA,EACrE,EAAC,IAAA,EAAM,CAAC,MAAA,EAAQ,OAAA,EAAS,UAAA,EAAY,GAAG,CAAA,EAAG,IAAA,EAAM,QAAA,EAAU,KAAA,EAAO,MAAA,EAAM;AAAA,EACxE,EAAC,IAAA,EAAM,CAAC,MAAA,EAAQ,OAAA,EAAS,UAAA,EAAY,GAAG,CAAA,EAAG,IAAA,EAAM,QAAA,EAAU,KAAA,EAAO,MAAA,EAAM;AAAA,EACxE,EAAC,IAAA,EAAM,CAAC,MAAA,EAAQ,OAAA,EAAS,UAAU,CAAA,EAAG,IAAA,EAAM,MAAA,EAAQ,KAAA,EAAO,IAAA,EAAI;AAAA,EAC/D,EAAC,MAAM,CAAC,MAAA,EAAQ,OAAO,CAAA,EAAG,IAAA,EAAM,YAAA,EAAc,KAAA,EAAO,MAAA,EAAM;AAAA,EAC3D,EAAC,MAAM,CAAC,MAAA,EAAQ,QAAQ,CAAA,EAAG,IAAA,EAAM,aAAA,EAAe,KAAA,EAAO,MAAA,EAAM;AAAA,EAC7D,EAAC,MAAM,CAAC,MAAA,EAAQ,aAAa,CAAA,EAAG,IAAA,EAAM,kBAAA,EAAoB,KAAA,EAAO,OAAA,EAAO;AAAA,EAExE,EAAC,MAAM,CAAC,MAAA,EAAQ,MAAM,CAAA,EAAG,IAAA,EAAM,MAAA,EAAQ,KAAA,EAAO,IAAA,EAAI;AAAA,EAClD;AAAA,IACI,IAAA,EAAM,CAAC,MAAA,EAAQ,OAAO,CAAA;AAAA,IACtB,IAAA,EAAM,YAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,SAAA,EAAW,CAAC,CAAA,KAAM,OAAO,MAAM,QAAA,GAAW,YAAA,CAAa,CAAC,CAAA,GAAI;AAAA,GAChE;AAAA,EACA,EAAC,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,EAAG,IAAA,EAAM,cAAA,EAAgB,KAAA,EAAO,MAAA,EAAM;AAAA,EAC/D,EAAC,MAAM,CAAC,MAAA,EAAQ,MAAM,CAAA,EAAG,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,MAAA,EAAM;AAAA,EACzD,EAAC,MAAM,CAAC,MAAA,EAAQ,MAAM,CAAA,EAAG,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,MAAA,EAAM;AAAA,EACzD,EAAC,MAAM,CAAC,MAAA,EAAQ,UAAU,CAAA,EAAG,IAAA,EAAM,eAAA,EAAiB,KAAA,EAAO,OAAA,EAAO;AAAA,EAClE,EAAC,MAAM,CAAC,MAAA,EAAQ,UAAU,CAAA,EAAG,IAAA,EAAM,eAAA,EAAiB,KAAA,EAAO,MAAA,EAAM;AAAA,EACjE;AAAA,IACI,IAAA,EAAM,CAAC,MAAA,EAAQ,YAAY,CAAA;AAAA,IAC3B,IAAA,EAAM,iBAAA;AAAA,IACN,KAAA,EAAO,OAAA;AAAA,IACP,SAAA,EAAW,CAAC,CAAA,KAAM,OAAO,MAAM,QAAA,GAAW,YAAA,CAAa,CAAC,CAAA,GAAI;AAAA,GAChE;AAAA,EACA,EAAC,MAAM,CAAC,MAAA,EAAQ,mBAAmB,CAAA,EAAG,IAAA,EAAM,wBAAA,EAA0B,KAAA,EAAO,SAAA,EAAS;AAAA,EAEtF,EAAC,MAAM,CAAC,WAAA,EAAa,MAAM,CAAA,EAAG,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,IAAA,EAAI;AAAA,EAC5D,EAAC,MAAM,CAAC,WAAA,EAAa,SAAS,CAAA,EAAG,IAAA,EAAM,mBAAA,EAAqB,KAAA,EAAO,MAAA,EAAM;AAAA,EACzE,EAAC,MAAM,CAAC,WAAA,EAAa,MAAM,CAAA,EAAG,IAAA,EAAM,gBAAA,EAAkB,KAAA,EAAO,MAAA,EAAM;AAAA,EACnE,EAAC,MAAM,CAAC,WAAA,EAAa,OAAO,CAAA,EAAG,IAAA,EAAM,iBAAA,EAAmB,KAAA,EAAO,MAAA,EAAM;AAAA,EACrE,EAAC,MAAM,CAAC,WAAA,EAAa,QAAQ,CAAA,EAAG,IAAA,EAAM,kBAAA,EAAoB,KAAA,EAAO,MAAA,EAAM;AAAA,EACvE,EAAC,MAAM,CAAC,WAAA,EAAa,UAAU,CAAA,EAAG,IAAA,EAAM,oBAAA,EAAsB,KAAA,EAAO,MAAA;AACzE,CAAA;;;ACrCO,IAAM,gBAAA,GAAmB,CAC5B,OAAA,EACA,IAAA,GAAiB,OAAA,KACR;AACT,EAAA,MAAM,SAAkC,EAAC;AAEzC,EAAA,KAAA,MAAW,QAAQ,MAAA,EAAQ;AACvB,IAAA,MAAM,KAAA,GAAQ,cAAA,CAAe,OAAA,EAAS,IAAA,CAAK,IAAI,CAAA;AAC/C,IAAA,IAAI,SAAS,IAAA,EAAM;AAEnB,IAAA,MAAM,OACF,IAAA,KAAS,OAAA,IAAW,KAAK,KAAA,GAAQ,IAAA,CAAK,QAAQ,IAAA,CAAK,IAAA;AAEvD,IAAA,IAAI,UAAA,GAAa,KAAA;AACjB,IAAA,IAAI,eAAe,IAAA,EAAM;AACrB,MAAA,UAAA,GAAa,IAAA,CAAK,UAAU,KAAK,CAAA;AAAA,IACrC;AAEA,IAAA,MAAA,CAAO,KAAK,CAAC,IAAA,EAAM,MAAA,CAAO,UAAU,CAAC,CAAC,CAAA;AAAA,EAC1C;AAGA,EAAA,OAAO,IAAI,eAAA;AAAA,IACP,MAAA,CAAO,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,KAAM,CAAC,CAAA,EAAG,CAAC,CAAC;AAAA,IAC/B,QAAA,EAAS;AAEf;AAwCO,IAAM,sBAAA,GAAyB,CAClC,MAAA,EACA,OAAA,EACA,OAAiB,OAAA,KAChB;AACD,EAAA,IAAI,QAAQ,QAAA,EAAU;AAClB,IAAA,OAAO,CAAA,EAAG,OAAO,OAAO,CAAA,SAAA,CAAA;AAAA,EAC5B;AAEA,EAAA,MAAM,KAAA,GAAQ,gBAAA,CAAiB,OAAA,EAAS,IAAI,CAAA;AAE5C,EAAA,MAAM,OAAA,GAAU,mBAAA,CAAoB,MAAA,CAAO,OAAO,CAAA;AAClD,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA;AAC9B","file":"index.cjs","sourcesContent":["/**\r\n * Helper type to extract values from const objects\r\n */\r\ntype ObjectValue<T> = T[keyof T];\r\n\r\n/**\r\n * Resize mode for image transformations\r\n */\r\nexport type ResizeMode = 'FILL' | 'FIT' | 'PAD' | 'FORCE' | 'COVER';\r\n\r\n/**\r\n * Output image format - null or empty means AUTO\r\n */\r\nexport type ImageFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif'\r\n\r\n/**\r\n * Position for text overlays and watermarks\r\n */\r\nexport type Position =\r\n    | 'TOP_LEFT'\r\n    | 'TOP_CENTER'\r\n    | 'TOP_RIGHT'\r\n    | 'CENTER_LEFT'\r\n    | 'CENTER'\r\n    | 'CENTER_RIGHT'\r\n    | 'BOTTOM_LEFT'\r\n    | 'BOTTOM_CENTER'\r\n    | 'BOTTOM_RIGHT';\r\n\r\n/**\r\n * Crop focus type\r\n */\r\nexport const CROP_FOCUS = {\r\n    SPECIFIED: 'SPECIFIED',\r\n    AUTO: 'AUTO',\r\n} as const;\r\n\r\nexport type CropFocus = ObjectValue<typeof CROP_FOCUS>;\r\n\r\n/**\r\n * Crop focus strategy for AUTO focus\r\n */\r\nexport const CROP_FOCUS_STRATEGY = {\r\n    CENTER: 'CENTER',\r\n    SMART: 'SMART',\r\n    DETAIL: 'DETAIL',\r\n} as const;\r\n\r\nexport type CropFocusStrategy = ObjectValue<typeof CROP_FOCUS_STRATEGY>;\r\n\r\n/**\r\n * Crop type\r\n */\r\nexport const CROP_TYPE = {\r\n    SIMPLE: 'SIMPLE',\r\n    OBJECT: 'OBJECT',\r\n} as const;\r\n\r\nexport type CropType = ObjectValue<typeof CROP_TYPE>;\r\n\r\n/**\r\n * Object type for smart cropping\r\n */\r\nexport const CROP_OBJECT_TYPE = {\r\n    FACE: 'FACE',\r\n    UPPER_BODY: 'UPPER_BODY',\r\n} as const;\r\n\r\nexport type CropObjectType = ObjectValue<typeof CROP_OBJECT_TYPE>;\r\n\r\n/**\r\n * Rotation angle in degrees (clockwise)\r\n */\r\nexport type RotationAngle = 0 | 90 | 180 | 270;\r\n\r\n/**\r\n * Device pixel ratio for high-density displays\r\n */\r\nexport type DevicePixelRatio = 1 | 2 | 3 | 4;\r\n\r\n/**\r\n * Hex color string (with or without #)\r\n */\r\nexport type HexColor = string;\r\n\r\n/**\r\n * Resize transformation options\r\n */\r\nexport interface ResizeOptions {\r\n    /** Target width in pixels (1-4096) */\r\n    width?: number;\r\n    /** Target height in pixels (1-4096) */\r\n    height?: number;\r\n    /** Device pixel ratio for retina displays */\r\n    dpr?: DevicePixelRatio;\r\n    /** Resize strategy */\r\n    mode?: ResizeMode;\r\n    /** Background color for PAD mode (hex) */\r\n    background?: HexColor;\r\n}\r\n\r\n/**\r\n * Format and quality options\r\n */\r\nexport interface FormatOptions {\r\n    /** Output format */\r\n    format?: ImageFormat;\r\n    /** Quality level (1-100) */\r\n    quality?: number;\r\n    /** Strip metadata from output */\r\n    stripMetadata?: boolean;\r\n}\r\n\r\n/**\r\n * Effect transformation options\r\n */\r\nexport interface EffectOptions {\r\n    /** Gaussian blur intensity (0-100) */\r\n    blur?: number;\r\n    /** Brightness adjustment (0-100) */\r\n    brightness?: number;\r\n    /** Contrast adjustment (0-100) */\r\n    contrast?: number;\r\n    /** Convert to grayscale */\r\n    grayscale?: boolean;\r\n    /** Saturation adjustment (0-100) */\r\n    saturation?: number;\r\n    /** Apply sepia effect */\r\n    sepia?: boolean;\r\n    /** Sharpen intensity (0-100) */\r\n    sharpen?: number;\r\n    /** Add noise intensity (0-100) */\r\n    noise?: number;\r\n    /** Rotation angle */\r\n    rotate?: RotationAngle;\r\n}\r\n\r\n/**\r\n * Border options\r\n */\r\nexport interface BorderOptions {\r\n    /** Border width in pixels */\r\n    width?: number;\r\n    /** Border color (hex) */\r\n    color?: HexColor;\r\n    /** Corner radius in pixels (1-2000) */\r\n    radius?: number;\r\n}\r\n\r\n/**\r\n * Crop focus position for SPECIFIED focus type\r\n */\r\nexport interface CropFocusPosition {\r\n    x?: number;\r\n    y?: number;\r\n}\r\n\r\n/**\r\n * Crop focus options\r\n */\r\nexport interface CropFocusOptions {\r\n    /** Focus type - SPECIFIED (manual position) or AUTO (strategy-based) */\r\n    type?: CropFocus;\r\n    /** Manual focus position when type is SPECIFIED */\r\n    position?: CropFocusPosition;\r\n    /** Auto focus strategy when type is AUTO */\r\n    strategy?: CropFocusStrategy;\r\n}\r\n\r\n/**\r\n * Crop options\r\n */\r\nexport interface CropOptions {\r\n    /** Crop type - SIMPLE or OBJECT */\r\n    type?: CropType;\r\n    /** Object type for OBJECT crop type */\r\n    objectType?: CropObjectType;\r\n    /** Focus options */\r\n    focus?: CropFocusOptions;\r\n    /** Crop width in pixels */\r\n    width?: number;\r\n    /** Crop height in pixels */\r\n    height?: number;\r\n    /** Apply crop after resize */\r\n    afterResize?: boolean;\r\n}\r\n\r\n/**\r\n * Text overlay options\r\n */\r\nexport interface TextOptions {\r\n    /** Text content to render */\r\n    text?: string;\r\n    /** Text color (hex) */\r\n    color?: HexColor;\r\n    /** Text opacity (0-100) */\r\n    opacity?: number;\r\n    /** Background color behind text (hex) */\r\n    background?: HexColor;\r\n    /** Background opacity (0-100) */\r\n    backgroundOpacity?: number;\r\n    /** Text size as percentage of image (1-100) */\r\n    size?: number;\r\n    /** Font family name */\r\n    font?: string;\r\n    /** Font size in pixels */\r\n    fontSize?: number;\r\n    /** Text position */\r\n    position?: Position;\r\n}\r\n\r\n/**\r\n * Watermark options\r\n */\r\nexport interface WatermarkOptions {\r\n    /** Watermark name (predefined in dashboard) */\r\n    name?: string;\r\n    /** Watermark opacity (0-100) */\r\n    opacity?: number;\r\n    /** Watermark size as percentage (1-100) */\r\n    size?: number;\r\n    /** Watermark width in pixels */\r\n    width?: number;\r\n    /** Watermark height in pixels */\r\n    height?: number;\r\n    /** Watermark position */\r\n    position?: Position;\r\n}\r\n\r\n/**\r\n * All transformation options combined\r\n */\r\nexport interface TransformationOptions\r\n    extends ResizeOptions,\r\n        FormatOptions,\r\n        EffectOptions {\r\n    /** Border options */\r\n    border?: BorderOptions;\r\n    /** Crop options */\r\n    crop?: CropOptions;\r\n    /** Text overlay options */\r\n    text?: TextOptions;\r\n    /** Watermark options */\r\n    watermark?: WatermarkOptions;\r\n    /** Use predefined transformation alias */\r\n    alias?: string;\r\n    /** Return original image without transformations */\r\n    original?: boolean;\r\n}\r\n\r\n/**\r\n * Configuration for PixelFiddler client\r\n */\r\nexport interface PixelFiddlerConfig {\r\n    /** Base URL for the CDN (defaults to https://cdn.pixel-fiddler.com) */\r\n    baseUrl?: string;\r\n    /** Secret key for URL signing */\r\n    signatureKey?: string;\r\n}\r\n\r\n/**\r\n * URL builder configuration (internal)\r\n */\r\nexport interface UrlBuilderConfig extends PixelFiddlerConfig {\r\n    /** Resolved base URL */\r\n    baseUrl: string;\r\n}\r\n\r\n/**\r\n * Mapping of transformation options to query parameter names\r\n */\r\nexport interface QueryParameterMapping {\r\n    /** Full parameter name */\r\n    name: string;\r\n    /** Short alias */\r\n    alias?: string;\r\n}\r\n\r\n\r\n","import { Path, PathValue } from './util-types';\r\n\r\nexport const normalizeHex = (value: string) => value.replace('#', '')\r\n\r\n\r\nexport const removeTrailingSlash = (baseUrl: string) => {\r\n    return baseUrl.endsWith('/')\r\n        ? baseUrl.slice(0, -1)\r\n        : baseUrl;\r\n}\r\n\r\nexport const getNestedValue = <\r\n    T,\r\n    P extends Path<T>\r\n>(\r\n    obj: T,\r\n    path: P\r\n): PathValue<T, P> | undefined =>\r\n    path.reduce<any>(\r\n        (acc, key) => (acc == null ? undefined : acc[key]),\r\n        obj\r\n    );\r\n\r\n","import { ParamSpec, Path } from './util-types';\r\nimport { TransformationOptions } from './types';\r\nimport { normalizeHex } from './utils';\r\n\r\nexport const PARAMS = [\r\n    {path: ['width'], long: 'width', short: 'w'},\r\n    {path: ['height'], long: 'height', short: 'h'},\r\n    {path: ['dpr'], long: 'dpr', short: 'dpr'},\r\n    {path: ['mode'], long: 'mode', short: 'rm'},\r\n    {\r\n        path: ['background'],\r\n        long: 'background',\r\n        short: 'bg',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n\r\n    {path: ['format'], long: 'format', short: 'f'},\r\n    {path: ['quality'], long: 'quality', short: 'q'},\r\n    {path: ['stripMetadata'], long: 'stripMetadata', short: 'st'},\r\n\r\n    {path: ['blur'], long: 'blur', short: 'bl'},\r\n    {path: ['brightness'], long: 'brightness', short: 'br'},\r\n    {path: ['contrast'], long: 'contrast', short: 'ct'},\r\n    {path: ['grayscale'], long: 'grayscale', short: 'gs'},\r\n    {path: ['saturation'], long: 'saturation', short: 'sa'},\r\n    {path: ['sepia'], long: 'sepia', short: 'sp'},\r\n    {path: ['sharpen'], long: 'sharpen', short: 'sh'},\r\n    {path: ['noise'], long: 'noise', short: 'ns'},\r\n    {path: ['rotate'], long: 'rotate', short: 'rt'},\r\n\r\n    {path: ['border', 'width'], long: 'border.width', short: 'bo.w'},\r\n    {\r\n        path: ['border', 'color'],\r\n        long: 'border.color',\r\n        short: 'bo.c',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n    {path: ['border', 'radius'], long: 'border.radius', short: 'bo.r'},\r\n\r\n    {path: ['crop', 'type'], long: 'crop.type', short: 'cr.t'},\r\n    {path: ['crop', 'objectType'], long: 'crop.objectType', short: 'cr.o'},\r\n    {path: ['crop', 'focus', 'position', 'x'], long: 'crop.x', short: 'cr.x'},\r\n    {path: ['crop', 'focus', 'position', 'y'], long: 'crop.y', short: 'cr.y'},\r\n    {path: ['crop', 'focus', 'strategy'], long: 'crop', short: 'cr'},\r\n    {path: ['crop', 'width'], long: 'crop.width', short: 'cr.w'},\r\n    {path: ['crop', 'height'], long: 'crop.height', short: 'cr.h'},\r\n    {path: ['crop', 'afterResize'], long: 'crop.afterResize', short: 'cr.ar'},\r\n\r\n    {path: ['text', 'text'], long: 'text', short: 'tx'},\r\n    {\r\n        path: ['text', 'color'],\r\n        long: 'text.color',\r\n        short: 'tx.c',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n    {path: ['text', 'opacity'], long: 'text.opacity', short: 'tx.o'},\r\n    {path: ['text', 'size'], long: 'text.size', short: 'tx.s'},\r\n    {path: ['text', 'font'], long: 'text.font', short: 'tx.f'},\r\n    {path: ['text', 'fontSize'], long: 'text.fontSize', short: 'tx.fs'},\r\n    {path: ['text', 'position'], long: 'text.position', short: 'tx.p'},\r\n    {\r\n        path: ['text', 'background'],\r\n        long: 'text.background',\r\n        short: 'tx.bg',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n    {path: ['text', 'backgroundOpacity'], long: 'text.backgroundOpacity', short: 'tx.bg.o'},\r\n\r\n    {path: ['watermark', 'name'], long: 'watermark', short: 'wm'},\r\n    {path: ['watermark', 'opacity'], long: 'watermark.opacity', short: 'wm.o'},\r\n    {path: ['watermark', 'size'], long: 'watermark.size', short: 'wm.s'},\r\n    {path: ['watermark', 'width'], long: 'watermark.width', short: 'wm.w'},\r\n    {path: ['watermark', 'height'], long: 'watermark.height', short: 'wm.h'},\r\n    {path: ['watermark', 'position'], long: 'watermark.position', short: 'wm.p'},\r\n] as const satisfies readonly ParamSpec<\r\n    TransformationOptions,\r\n    Path<TransformationOptions>\r\n>[];\r\n","import { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { getNestedValue, removeTrailingSlash } from './utils';\r\nimport { PARAMS } from './config';\r\n\r\n/**\r\n * Determines which parameter names to use in the query string.\r\n * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)\r\n * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)\r\n */\r\ntype NameMode = 'short' | 'long';\r\n\r\n/**\r\n * Converts transformation options into a URL-encoded query string.\r\n *\r\n * Iterates through all defined parameters in the PARAMS config, extracts values\r\n * from the options object using their paths, applies any normalization functions\r\n * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.\r\n *\r\n * @param options - The transformation options object\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns URL-encoded query string (without leading `?`)\r\n *\r\n * @example\r\n * ```ts\r\n * // Using short aliases (default)\r\n * buildQueryParams({ width: 800, height: 600, quality: 80 });\r\n * // => 'w=800&h=600&q=80'\r\n *\r\n * // Using long parameter names\r\n * buildQueryParams({ width: 800, format: 'webp' }, 'long');\r\n * // => 'width=800&format=webp'\r\n *\r\n * // Nested options\r\n * buildQueryParams({ border: { width: 2, color: '#ff0000' } });\r\n * // => 'bo.w=2&bo.c=ff0000'\r\n * ```\r\n */\r\nexport const buildQueryParams = (\r\n    options: TransformationOptions,\r\n    mode: NameMode = 'short'\r\n): string => {\r\n    const params: Array<[string, string]> = [];\r\n\r\n    for (const spec of PARAMS) {\r\n        const value = getNestedValue(options, spec.path);\r\n        if (value == null) continue;\r\n\r\n        const name =\r\n            mode === 'short' && spec.short ? spec.short : spec.long;\r\n\r\n        let normalized = value\r\n        if ('normalize' in spec) {\r\n            normalized = spec.normalize(value)\r\n        }\r\n\r\n        params.push([name, String(normalized)]);\r\n    }\r\n\r\n\r\n    return new URLSearchParams(\r\n        params.map(([k, v]) => [k, v])\r\n    ).toString();\r\n\r\n};\r\n\r\n/**\r\n * Builds a complete transformation URL from a base URL and transformation options.\r\n *\r\n * Combines the configured base URL with query parameters generated from the\r\n * transformation options. Handles the special `original` flag which returns\r\n * the unmodified source image.\r\n *\r\n * @param config - Configuration containing the base URL for the image\r\n * @param options - The transformation options to apply\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns The complete URL string with query parameters\r\n *\r\n * @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };\r\n *\r\n * // Basic resize\r\n * buildTransformationUrl(config, { width: 400, height: 300 });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'\r\n *\r\n * // Multiple transformations\r\n * buildTransformationUrl(config, {\r\n *   width: 800,\r\n *   format: 'webp',\r\n *   quality: 85,\r\n *   blur: 5\r\n * });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'\r\n *\r\n * // Request original image (no transformations)\r\n * buildTransformationUrl(config, { original: true });\r\n * // => 'https://cdn.example.com/images/photo.jpg?original'\r\n *\r\n * // Using long parameter names\r\n * buildTransformationUrl(config, { width: 400 }, 'long');\r\n * // => 'https://cdn.example.com/images/photo.jpg?width=400'\r\n * ```\r\n */\r\nexport const buildTransformationUrl = (\r\n    config: UrlBuilderConfig,\r\n    options: TransformationOptions,\r\n    mode: NameMode = 'short'\r\n) => {\r\n    if (options.original) {\r\n        return `${config.baseUrl}?original`;\r\n    }\r\n\r\n    const query = buildQueryParams(options, mode);\r\n\r\n    const baseUrl = removeTrailingSlash(config.baseUrl)\r\n    return `${baseUrl}?${query}`;\r\n};\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,304 @@
+/**
+ * Helper type to extract values from const objects
+ */
+type ObjectValue<T> = T[keyof T];
+/**
+ * Resize mode for image transformations
+ */
+type ResizeMode = 'FILL' | 'FIT' | 'PAD' | 'FORCE' | 'COVER';
+/**
+ * Output image format - null or empty means AUTO
+ */
+type ImageFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif';
+/**
+ * Position for text overlays and watermarks
+ */
+type Position = 'TOP_LEFT' | 'TOP_CENTER' | 'TOP_RIGHT' | 'CENTER_LEFT' | 'CENTER' | 'CENTER_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_CENTER' | 'BOTTOM_RIGHT';
+/**
+ * Crop focus type
+ */
+declare const CROP_FOCUS: {
+    readonly SPECIFIED: "SPECIFIED";
+    readonly AUTO: "AUTO";
+};
+type CropFocus = ObjectValue<typeof CROP_FOCUS>;
+/**
+ * Crop focus strategy for AUTO focus
+ */
+declare const CROP_FOCUS_STRATEGY: {
+    readonly CENTER: "CENTER";
+    readonly SMART: "SMART";
+    readonly DETAIL: "DETAIL";
+};
+type CropFocusStrategy = ObjectValue<typeof CROP_FOCUS_STRATEGY>;
+/**
+ * Crop type
+ */
+declare const CROP_TYPE: {
+    readonly SIMPLE: "SIMPLE";
+    readonly OBJECT: "OBJECT";
+};
+type CropType = ObjectValue<typeof CROP_TYPE>;
+/**
+ * Object type for smart cropping
+ */
+declare const CROP_OBJECT_TYPE: {
+    readonly FACE: "FACE";
+    readonly UPPER_BODY: "UPPER_BODY";
+};
+type CropObjectType = ObjectValue<typeof CROP_OBJECT_TYPE>;
+/**
+ * Rotation angle in degrees (clockwise)
+ */
+type RotationAngle = 0 | 90 | 180 | 270;
+/**
+ * Device pixel ratio for high-density displays
+ */
+type DevicePixelRatio = 1 | 2 | 3 | 4;
+/**
+ * Hex color string (with or without #)
+ */
+type HexColor = string;
+/**
+ * Resize transformation options
+ */
+interface ResizeOptions {
+    /** Target width in pixels (1-4096) */
+    width?: number;
+    /** Target height in pixels (1-4096) */
+    height?: number;
+    /** Device pixel ratio for retina displays */
+    dpr?: DevicePixelRatio;
+    /** Resize strategy */
+    mode?: ResizeMode;
+    /** Background color for PAD mode (hex) */
+    background?: HexColor;
+}
+/**
+ * Format and quality options
+ */
+interface FormatOptions {
+    /** Output format */
+    format?: ImageFormat;
+    /** Quality level (1-100) */
+    quality?: number;
+    /** Strip metadata from output */
+    stripMetadata?: boolean;
+}
+/**
+ * Effect transformation options
+ */
+interface EffectOptions {
+    /** Gaussian blur intensity (0-100) */
+    blur?: number;
+    /** Brightness adjustment (0-100) */
+    brightness?: number;
+    /** Contrast adjustment (0-100) */
+    contrast?: number;
+    /** Convert to grayscale */
+    grayscale?: boolean;
+    /** Saturation adjustment (0-100) */
+    saturation?: number;
+    /** Apply sepia effect */
+    sepia?: boolean;
+    /** Sharpen intensity (0-100) */
+    sharpen?: number;
+    /** Add noise intensity (0-100) */
+    noise?: number;
+    /** Rotation angle */
+    rotate?: RotationAngle;
+}
+/**
+ * Border options
+ */
+interface BorderOptions {
+    /** Border width in pixels */
+    width?: number;
+    /** Border color (hex) */
+    color?: HexColor;
+    /** Corner radius in pixels (1-2000) */
+    radius?: number;
+}
+/**
+ * Crop focus position for SPECIFIED focus type
+ */
+interface CropFocusPosition {
+    x?: number;
+    y?: number;
+}
+/**
+ * Crop focus options
+ */
+interface CropFocusOptions {
+    /** Focus type - SPECIFIED (manual position) or AUTO (strategy-based) */
+    type?: CropFocus;
+    /** Manual focus position when type is SPECIFIED */
+    position?: CropFocusPosition;
+    /** Auto focus strategy when type is AUTO */
+    strategy?: CropFocusStrategy;
+}
+/**
+ * Crop options
+ */
+interface CropOptions {
+    /** Crop type - SIMPLE or OBJECT */
+    type?: CropType;
+    /** Object type for OBJECT crop type */
+    objectType?: CropObjectType;
+    /** Focus options */
+    focus?: CropFocusOptions;
+    /** Crop width in pixels */
+    width?: number;
+    /** Crop height in pixels */
+    height?: number;
+    /** Apply crop after resize */
+    afterResize?: boolean;
+}
+/**
+ * Text overlay options
+ */
+interface TextOptions {
+    /** Text content to render */
+    text?: string;
+    /** Text color (hex) */
+    color?: HexColor;
+    /** Text opacity (0-100) */
+    opacity?: number;
+    /** Background color behind text (hex) */
+    background?: HexColor;
+    /** Background opacity (0-100) */
+    backgroundOpacity?: number;
+    /** Text size as percentage of image (1-100) */
+    size?: number;
+    /** Font family name */
+    font?: string;
+    /** Font size in pixels */
+    fontSize?: number;
+    /** Text position */
+    position?: Position;
+}
+/**
+ * Watermark options
+ */
+interface WatermarkOptions {
+    /** Watermark name (predefined in dashboard) */
+    name?: string;
+    /** Watermark opacity (0-100) */
+    opacity?: number;
+    /** Watermark size as percentage (1-100) */
+    size?: number;
+    /** Watermark width in pixels */
+    width?: number;
+    /** Watermark height in pixels */
+    height?: number;
+    /** Watermark position */
+    position?: Position;
+}
+/**
+ * All transformation options combined
+ */
+interface TransformationOptions extends ResizeOptions, FormatOptions, EffectOptions {
+    /** Border options */
+    border?: BorderOptions;
+    /** Crop options */
+    crop?: CropOptions;
+    /** Text overlay options */
+    text?: TextOptions;
+    /** Watermark options */
+    watermark?: WatermarkOptions;
+    /** Use predefined transformation alias */
+    alias?: string;
+    /** Return original image without transformations */
+    original?: boolean;
+}
+/**
+ * Configuration for PixelFiddler client
+ */
+interface PixelFiddlerConfig {
+    /** Base URL for the CDN (defaults to https://cdn.pixel-fiddler.com) */
+    baseUrl?: string;
+    /** Secret key for URL signing */
+    signatureKey?: string;
+}
+/**
+ * URL builder configuration (internal)
+ */
+interface UrlBuilderConfig extends PixelFiddlerConfig {
+    /** Resolved base URL */
+    baseUrl: string;
+}
+
+/**
+ * Determines which parameter names to use in the query string.
+ * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)
+ * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)
+ */
+type NameMode = 'short' | 'long';
+/**
+ * Converts transformation options into a URL-encoded query string.
+ *
+ * Iterates through all defined parameters in the PARAMS config, extracts values
+ * from the options object using their paths, applies any normalization functions
+ * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.
+ *
+ * @param options - The transformation options object
+ * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)
+ * @returns URL-encoded query string (without leading `?`)
+ *
+ * @example
+ * ```ts
+ * // Using short aliases (default)
+ * buildQueryParams({ width: 800, height: 600, quality: 80 });
+ * // => 'w=800&h=600&q=80'
+ *
+ * // Using long parameter names
+ * buildQueryParams({ width: 800, format: 'webp' }, 'long');
+ * // => 'width=800&format=webp'
+ *
+ * // Nested options
+ * buildQueryParams({ border: { width: 2, color: '#ff0000' } });
+ * // => 'bo.w=2&bo.c=ff0000'
+ * ```
+ */
+declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode) => string;
+/**
+ * Builds a complete transformation URL from a base URL and transformation options.
+ *
+ * Combines the configured base URL with query parameters generated from the
+ * transformation options. Handles the special `original` flag which returns
+ * the unmodified source image.
+ *
+ * @param config - Configuration containing the base URL for the image
+ * @param options - The transformation options to apply
+ * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)
+ * @returns The complete URL string with query parameters
+ *
+ * @example
+ * ```ts
+ * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };
+ *
+ * // Basic resize
+ * buildTransformationUrl(config, { width: 400, height: 300 });
+ * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'
+ *
+ * // Multiple transformations
+ * buildTransformationUrl(config, {
+ *   width: 800,
+ *   format: 'webp',
+ *   quality: 85,
+ *   blur: 5
+ * });
+ * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'
+ *
+ * // Request original image (no transformations)
+ * buildTransformationUrl(config, { original: true });
+ * // => 'https://cdn.example.com/images/photo.jpg?original'
+ *
+ * // Using long parameter names
+ * buildTransformationUrl(config, { width: 400 }, 'long');
+ * // => 'https://cdn.example.com/images/photo.jpg?width=400'
+ * ```
+ */
+declare const buildTransformationUrl: (config: UrlBuilderConfig, options: TransformationOptions, mode?: NameMode) => string;
+
+export { type BorderOptions, CROP_FOCUS, CROP_FOCUS_STRATEGY, CROP_OBJECT_TYPE, CROP_TYPE, type CropFocus, type CropFocusOptions, type CropFocusPosition, type CropFocusStrategy, type CropObjectType, type CropOptions, type CropType, type DevicePixelRatio, type EffectOptions, type FormatOptions, type HexColor, type ImageFormat, type PixelFiddlerConfig, type Position, type ResizeMode, type ResizeOptions, type RotationAngle, type TextOptions, type TransformationOptions, type UrlBuilderConfig, type WatermarkOptions, buildQueryParams, buildTransformationUrl };

package/dist/index.d.ts

@@ -0,0 +1,304 @@
+/**
+ * Helper type to extract values from const objects
+ */
+type ObjectValue<T> = T[keyof T];
+/**
+ * Resize mode for image transformations
+ */
+type ResizeMode = 'FILL' | 'FIT' | 'PAD' | 'FORCE' | 'COVER';
+/**
+ * Output image format - null or empty means AUTO
+ */
+type ImageFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif';
+/**
+ * Position for text overlays and watermarks
+ */
+type Position = 'TOP_LEFT' | 'TOP_CENTER' | 'TOP_RIGHT' | 'CENTER_LEFT' | 'CENTER' | 'CENTER_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_CENTER' | 'BOTTOM_RIGHT';
+/**
+ * Crop focus type
+ */
+declare const CROP_FOCUS: {
+    readonly SPECIFIED: "SPECIFIED";
+    readonly AUTO: "AUTO";
+};
+type CropFocus = ObjectValue<typeof CROP_FOCUS>;
+/**
+ * Crop focus strategy for AUTO focus
+ */
+declare const CROP_FOCUS_STRATEGY: {
+    readonly CENTER: "CENTER";
+    readonly SMART: "SMART";
+    readonly DETAIL: "DETAIL";
+};
+type CropFocusStrategy = ObjectValue<typeof CROP_FOCUS_STRATEGY>;
+/**
+ * Crop type
+ */
+declare const CROP_TYPE: {
+    readonly SIMPLE: "SIMPLE";
+    readonly OBJECT: "OBJECT";
+};
+type CropType = ObjectValue<typeof CROP_TYPE>;
+/**
+ * Object type for smart cropping
+ */
+declare const CROP_OBJECT_TYPE: {
+    readonly FACE: "FACE";
+    readonly UPPER_BODY: "UPPER_BODY";
+};
+type CropObjectType = ObjectValue<typeof CROP_OBJECT_TYPE>;
+/**
+ * Rotation angle in degrees (clockwise)
+ */
+type RotationAngle = 0 | 90 | 180 | 270;
+/**
+ * Device pixel ratio for high-density displays
+ */
+type DevicePixelRatio = 1 | 2 | 3 | 4;
+/**
+ * Hex color string (with or without #)
+ */
+type HexColor = string;
+/**
+ * Resize transformation options
+ */
+interface ResizeOptions {
+    /** Target width in pixels (1-4096) */
+    width?: number;
+    /** Target height in pixels (1-4096) */
+    height?: number;
+    /** Device pixel ratio for retina displays */
+    dpr?: DevicePixelRatio;
+    /** Resize strategy */
+    mode?: ResizeMode;
+    /** Background color for PAD mode (hex) */
+    background?: HexColor;
+}
+/**
+ * Format and quality options
+ */
+interface FormatOptions {
+    /** Output format */
+    format?: ImageFormat;
+    /** Quality level (1-100) */
+    quality?: number;
+    /** Strip metadata from output */
+    stripMetadata?: boolean;
+}
+/**
+ * Effect transformation options
+ */
+interface EffectOptions {
+    /** Gaussian blur intensity (0-100) */
+    blur?: number;
+    /** Brightness adjustment (0-100) */
+    brightness?: number;
+    /** Contrast adjustment (0-100) */
+    contrast?: number;
+    /** Convert to grayscale */
+    grayscale?: boolean;
+    /** Saturation adjustment (0-100) */
+    saturation?: number;
+    /** Apply sepia effect */
+    sepia?: boolean;
+    /** Sharpen intensity (0-100) */
+    sharpen?: number;
+    /** Add noise intensity (0-100) */
+    noise?: number;
+    /** Rotation angle */
+    rotate?: RotationAngle;
+}
+/**
+ * Border options
+ */
+interface BorderOptions {
+    /** Border width in pixels */
+    width?: number;
+    /** Border color (hex) */
+    color?: HexColor;
+    /** Corner radius in pixels (1-2000) */
+    radius?: number;
+}
+/**
+ * Crop focus position for SPECIFIED focus type
+ */
+interface CropFocusPosition {
+    x?: number;
+    y?: number;
+}
+/**
+ * Crop focus options
+ */
+interface CropFocusOptions {
+    /** Focus type - SPECIFIED (manual position) or AUTO (strategy-based) */
+    type?: CropFocus;
+    /** Manual focus position when type is SPECIFIED */
+    position?: CropFocusPosition;
+    /** Auto focus strategy when type is AUTO */
+    strategy?: CropFocusStrategy;
+}
+/**
+ * Crop options
+ */
+interface CropOptions {
+    /** Crop type - SIMPLE or OBJECT */
+    type?: CropType;
+    /** Object type for OBJECT crop type */
+    objectType?: CropObjectType;
+    /** Focus options */
+    focus?: CropFocusOptions;
+    /** Crop width in pixels */
+    width?: number;
+    /** Crop height in pixels */
+    height?: number;
+    /** Apply crop after resize */
+    afterResize?: boolean;
+}
+/**
+ * Text overlay options
+ */
+interface TextOptions {
+    /** Text content to render */
+    text?: string;
+    /** Text color (hex) */
+    color?: HexColor;
+    /** Text opacity (0-100) */
+    opacity?: number;
+    /** Background color behind text (hex) */
+    background?: HexColor;
+    /** Background opacity (0-100) */
+    backgroundOpacity?: number;
+    /** Text size as percentage of image (1-100) */
+    size?: number;
+    /** Font family name */
+    font?: string;
+    /** Font size in pixels */
+    fontSize?: number;
+    /** Text position */
+    position?: Position;
+}
+/**
+ * Watermark options
+ */
+interface WatermarkOptions {
+    /** Watermark name (predefined in dashboard) */
+    name?: string;
+    /** Watermark opacity (0-100) */
+    opacity?: number;
+    /** Watermark size as percentage (1-100) */
+    size?: number;
+    /** Watermark width in pixels */
+    width?: number;
+    /** Watermark height in pixels */
+    height?: number;
+    /** Watermark position */
+    position?: Position;
+}
+/**
+ * All transformation options combined
+ */
+interface TransformationOptions extends ResizeOptions, FormatOptions, EffectOptions {
+    /** Border options */
+    border?: BorderOptions;
+    /** Crop options */
+    crop?: CropOptions;
+    /** Text overlay options */
+    text?: TextOptions;
+    /** Watermark options */
+    watermark?: WatermarkOptions;
+    /** Use predefined transformation alias */
+    alias?: string;
+    /** Return original image without transformations */
+    original?: boolean;
+}
+/**
+ * Configuration for PixelFiddler client
+ */
+interface PixelFiddlerConfig {
+    /** Base URL for the CDN (defaults to https://cdn.pixel-fiddler.com) */
+    baseUrl?: string;
+    /** Secret key for URL signing */
+    signatureKey?: string;
+}
+/**
+ * URL builder configuration (internal)
+ */
+interface UrlBuilderConfig extends PixelFiddlerConfig {
+    /** Resolved base URL */
+    baseUrl: string;
+}
+
+/**
+ * Determines which parameter names to use in the query string.
+ * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)
+ * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)
+ */
+type NameMode = 'short' | 'long';
+/**
+ * Converts transformation options into a URL-encoded query string.
+ *
+ * Iterates through all defined parameters in the PARAMS config, extracts values
+ * from the options object using their paths, applies any normalization functions
+ * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.
+ *
+ * @param options - The transformation options object
+ * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)
+ * @returns URL-encoded query string (without leading `?`)
+ *
+ * @example
+ * ```ts
+ * // Using short aliases (default)
+ * buildQueryParams({ width: 800, height: 600, quality: 80 });
+ * // => 'w=800&h=600&q=80'
+ *
+ * // Using long parameter names
+ * buildQueryParams({ width: 800, format: 'webp' }, 'long');
+ * // => 'width=800&format=webp'
+ *
+ * // Nested options
+ * buildQueryParams({ border: { width: 2, color: '#ff0000' } });
+ * // => 'bo.w=2&bo.c=ff0000'
+ * ```
+ */
+declare const buildQueryParams: (options: TransformationOptions, mode?: NameMode) => string;
+/**
+ * Builds a complete transformation URL from a base URL and transformation options.
+ *
+ * Combines the configured base URL with query parameters generated from the
+ * transformation options. Handles the special `original` flag which returns
+ * the unmodified source image.
+ *
+ * @param config - Configuration containing the base URL for the image
+ * @param options - The transformation options to apply
+ * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)
+ * @returns The complete URL string with query parameters
+ *
+ * @example
+ * ```ts
+ * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };
+ *
+ * // Basic resize
+ * buildTransformationUrl(config, { width: 400, height: 300 });
+ * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'
+ *
+ * // Multiple transformations
+ * buildTransformationUrl(config, {
+ *   width: 800,
+ *   format: 'webp',
+ *   quality: 85,
+ *   blur: 5
+ * });
+ * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'
+ *
+ * // Request original image (no transformations)
+ * buildTransformationUrl(config, { original: true });
+ * // => 'https://cdn.example.com/images/photo.jpg?original'
+ *
+ * // Using long parameter names
+ * buildTransformationUrl(config, { width: 400 }, 'long');
+ * // => 'https://cdn.example.com/images/photo.jpg?width=400'
+ * ```
+ */
+declare const buildTransformationUrl: (config: UrlBuilderConfig, options: TransformationOptions, mode?: NameMode) => string;
+
+export { type BorderOptions, CROP_FOCUS, CROP_FOCUS_STRATEGY, CROP_OBJECT_TYPE, CROP_TYPE, type CropFocus, type CropFocusOptions, type CropFocusPosition, type CropFocusStrategy, type CropObjectType, type CropOptions, type CropType, type DevicePixelRatio, type EffectOptions, type FormatOptions, type HexColor, type ImageFormat, type PixelFiddlerConfig, type Position, type ResizeMode, type ResizeOptions, type RotationAngle, type TextOptions, type TransformationOptions, type UrlBuilderConfig, type WatermarkOptions, buildQueryParams, buildTransformationUrl };

package/dist/index.js

@@ -0,0 +1,125 @@
+// src/types.ts
+var CROP_FOCUS = {
+  SPECIFIED: "SPECIFIED",
+  AUTO: "AUTO"
+};
+var CROP_FOCUS_STRATEGY = {
+  CENTER: "CENTER",
+  SMART: "SMART",
+  DETAIL: "DETAIL"
+};
+var CROP_TYPE = {
+  SIMPLE: "SIMPLE",
+  OBJECT: "OBJECT"
+};
+var CROP_OBJECT_TYPE = {
+  FACE: "FACE",
+  UPPER_BODY: "UPPER_BODY"
+};
+
+// src/utils.ts
+var normalizeHex = (value) => value.replace("#", "");
+var removeTrailingSlash = (baseUrl) => {
+  return baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+};
+var getNestedValue = (obj, path) => path.reduce(
+  (acc, key) => acc == null ? void 0 : acc[key],
+  obj
+);
+
+// src/config.ts
+var PARAMS = [
+  { path: ["width"], long: "width", short: "w" },
+  { path: ["height"], long: "height", short: "h" },
+  { path: ["dpr"], long: "dpr", short: "dpr" },
+  { path: ["mode"], long: "mode", short: "rm" },
+  {
+    path: ["background"],
+    long: "background",
+    short: "bg",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["format"], long: "format", short: "f" },
+  { path: ["quality"], long: "quality", short: "q" },
+  { path: ["stripMetadata"], long: "stripMetadata", short: "st" },
+  { path: ["blur"], long: "blur", short: "bl" },
+  { path: ["brightness"], long: "brightness", short: "br" },
+  { path: ["contrast"], long: "contrast", short: "ct" },
+  { path: ["grayscale"], long: "grayscale", short: "gs" },
+  { path: ["saturation"], long: "saturation", short: "sa" },
+  { path: ["sepia"], long: "sepia", short: "sp" },
+  { path: ["sharpen"], long: "sharpen", short: "sh" },
+  { path: ["noise"], long: "noise", short: "ns" },
+  { path: ["rotate"], long: "rotate", short: "rt" },
+  { path: ["border", "width"], long: "border.width", short: "bo.w" },
+  {
+    path: ["border", "color"],
+    long: "border.color",
+    short: "bo.c",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["border", "radius"], long: "border.radius", short: "bo.r" },
+  { path: ["crop", "type"], long: "crop.type", short: "cr.t" },
+  { path: ["crop", "objectType"], long: "crop.objectType", short: "cr.o" },
+  { path: ["crop", "focus", "position", "x"], long: "crop.x", short: "cr.x" },
+  { path: ["crop", "focus", "position", "y"], long: "crop.y", short: "cr.y" },
+  { path: ["crop", "focus", "strategy"], long: "crop", short: "cr" },
+  { path: ["crop", "width"], long: "crop.width", short: "cr.w" },
+  { path: ["crop", "height"], long: "crop.height", short: "cr.h" },
+  { path: ["crop", "afterResize"], long: "crop.afterResize", short: "cr.ar" },
+  { path: ["text", "text"], long: "text", short: "tx" },
+  {
+    path: ["text", "color"],
+    long: "text.color",
+    short: "tx.c",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["text", "opacity"], long: "text.opacity", short: "tx.o" },
+  { path: ["text", "size"], long: "text.size", short: "tx.s" },
+  { path: ["text", "font"], long: "text.font", short: "tx.f" },
+  { path: ["text", "fontSize"], long: "text.fontSize", short: "tx.fs" },
+  { path: ["text", "position"], long: "text.position", short: "tx.p" },
+  {
+    path: ["text", "background"],
+    long: "text.background",
+    short: "tx.bg",
+    normalize: (v) => typeof v === "string" ? normalizeHex(v) : v
+  },
+  { path: ["text", "backgroundOpacity"], long: "text.backgroundOpacity", short: "tx.bg.o" },
+  { path: ["watermark", "name"], long: "watermark", short: "wm" },
+  { path: ["watermark", "opacity"], long: "watermark.opacity", short: "wm.o" },
+  { path: ["watermark", "size"], long: "watermark.size", short: "wm.s" },
+  { path: ["watermark", "width"], long: "watermark.width", short: "wm.w" },
+  { path: ["watermark", "height"], long: "watermark.height", short: "wm.h" },
+  { path: ["watermark", "position"], long: "watermark.position", short: "wm.p" }
+];
+
+// src/url-builder.ts
+var buildQueryParams = (options, mode = "short") => {
+  const params = [];
+  for (const spec of PARAMS) {
+    const value = getNestedValue(options, spec.path);
+    if (value == null) continue;
+    const name = mode === "short" && spec.short ? spec.short : spec.long;
+    let normalized = value;
+    if ("normalize" in spec) {
+      normalized = spec.normalize(value);
+    }
+    params.push([name, String(normalized)]);
+  }
+  return new URLSearchParams(
+    params.map(([k, v]) => [k, v])
+  ).toString();
+};
+var buildTransformationUrl = (config, options, mode = "short") => {
+  if (options.original) {
+    return `${config.baseUrl}?original`;
+  }
+  const query = buildQueryParams(options, mode);
+  const baseUrl = removeTrailingSlash(config.baseUrl);
+  return `${baseUrl}?${query}`;
+};
+
+export { CROP_FOCUS, CROP_FOCUS_STRATEGY, CROP_OBJECT_TYPE, CROP_TYPE, buildQueryParams, buildTransformationUrl };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/utils.ts","../src/config.ts","../src/url-builder.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Helper type to extract values from const objects\r\n */\r\ntype ObjectValue<T> = T[keyof T];\r\n\r\n/**\r\n * Resize mode for image transformations\r\n */\r\nexport type ResizeMode = 'FILL' | 'FIT' | 'PAD' | 'FORCE' | 'COVER';\r\n\r\n/**\r\n * Output image format - null or empty means AUTO\r\n */\r\nexport type ImageFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif'\r\n\r\n/**\r\n * Position for text overlays and watermarks\r\n */\r\nexport type Position =\r\n    | 'TOP_LEFT'\r\n    | 'TOP_CENTER'\r\n    | 'TOP_RIGHT'\r\n    | 'CENTER_LEFT'\r\n    | 'CENTER'\r\n    | 'CENTER_RIGHT'\r\n    | 'BOTTOM_LEFT'\r\n    | 'BOTTOM_CENTER'\r\n    | 'BOTTOM_RIGHT';\r\n\r\n/**\r\n * Crop focus type\r\n */\r\nexport const CROP_FOCUS = {\r\n    SPECIFIED: 'SPECIFIED',\r\n    AUTO: 'AUTO',\r\n} as const;\r\n\r\nexport type CropFocus = ObjectValue<typeof CROP_FOCUS>;\r\n\r\n/**\r\n * Crop focus strategy for AUTO focus\r\n */\r\nexport const CROP_FOCUS_STRATEGY = {\r\n    CENTER: 'CENTER',\r\n    SMART: 'SMART',\r\n    DETAIL: 'DETAIL',\r\n} as const;\r\n\r\nexport type CropFocusStrategy = ObjectValue<typeof CROP_FOCUS_STRATEGY>;\r\n\r\n/**\r\n * Crop type\r\n */\r\nexport const CROP_TYPE = {\r\n    SIMPLE: 'SIMPLE',\r\n    OBJECT: 'OBJECT',\r\n} as const;\r\n\r\nexport type CropType = ObjectValue<typeof CROP_TYPE>;\r\n\r\n/**\r\n * Object type for smart cropping\r\n */\r\nexport const CROP_OBJECT_TYPE = {\r\n    FACE: 'FACE',\r\n    UPPER_BODY: 'UPPER_BODY',\r\n} as const;\r\n\r\nexport type CropObjectType = ObjectValue<typeof CROP_OBJECT_TYPE>;\r\n\r\n/**\r\n * Rotation angle in degrees (clockwise)\r\n */\r\nexport type RotationAngle = 0 | 90 | 180 | 270;\r\n\r\n/**\r\n * Device pixel ratio for high-density displays\r\n */\r\nexport type DevicePixelRatio = 1 | 2 | 3 | 4;\r\n\r\n/**\r\n * Hex color string (with or without #)\r\n */\r\nexport type HexColor = string;\r\n\r\n/**\r\n * Resize transformation options\r\n */\r\nexport interface ResizeOptions {\r\n    /** Target width in pixels (1-4096) */\r\n    width?: number;\r\n    /** Target height in pixels (1-4096) */\r\n    height?: number;\r\n    /** Device pixel ratio for retina displays */\r\n    dpr?: DevicePixelRatio;\r\n    /** Resize strategy */\r\n    mode?: ResizeMode;\r\n    /** Background color for PAD mode (hex) */\r\n    background?: HexColor;\r\n}\r\n\r\n/**\r\n * Format and quality options\r\n */\r\nexport interface FormatOptions {\r\n    /** Output format */\r\n    format?: ImageFormat;\r\n    /** Quality level (1-100) */\r\n    quality?: number;\r\n    /** Strip metadata from output */\r\n    stripMetadata?: boolean;\r\n}\r\n\r\n/**\r\n * Effect transformation options\r\n */\r\nexport interface EffectOptions {\r\n    /** Gaussian blur intensity (0-100) */\r\n    blur?: number;\r\n    /** Brightness adjustment (0-100) */\r\n    brightness?: number;\r\n    /** Contrast adjustment (0-100) */\r\n    contrast?: number;\r\n    /** Convert to grayscale */\r\n    grayscale?: boolean;\r\n    /** Saturation adjustment (0-100) */\r\n    saturation?: number;\r\n    /** Apply sepia effect */\r\n    sepia?: boolean;\r\n    /** Sharpen intensity (0-100) */\r\n    sharpen?: number;\r\n    /** Add noise intensity (0-100) */\r\n    noise?: number;\r\n    /** Rotation angle */\r\n    rotate?: RotationAngle;\r\n}\r\n\r\n/**\r\n * Border options\r\n */\r\nexport interface BorderOptions {\r\n    /** Border width in pixels */\r\n    width?: number;\r\n    /** Border color (hex) */\r\n    color?: HexColor;\r\n    /** Corner radius in pixels (1-2000) */\r\n    radius?: number;\r\n}\r\n\r\n/**\r\n * Crop focus position for SPECIFIED focus type\r\n */\r\nexport interface CropFocusPosition {\r\n    x?: number;\r\n    y?: number;\r\n}\r\n\r\n/**\r\n * Crop focus options\r\n */\r\nexport interface CropFocusOptions {\r\n    /** Focus type - SPECIFIED (manual position) or AUTO (strategy-based) */\r\n    type?: CropFocus;\r\n    /** Manual focus position when type is SPECIFIED */\r\n    position?: CropFocusPosition;\r\n    /** Auto focus strategy when type is AUTO */\r\n    strategy?: CropFocusStrategy;\r\n}\r\n\r\n/**\r\n * Crop options\r\n */\r\nexport interface CropOptions {\r\n    /** Crop type - SIMPLE or OBJECT */\r\n    type?: CropType;\r\n    /** Object type for OBJECT crop type */\r\n    objectType?: CropObjectType;\r\n    /** Focus options */\r\n    focus?: CropFocusOptions;\r\n    /** Crop width in pixels */\r\n    width?: number;\r\n    /** Crop height in pixels */\r\n    height?: number;\r\n    /** Apply crop after resize */\r\n    afterResize?: boolean;\r\n}\r\n\r\n/**\r\n * Text overlay options\r\n */\r\nexport interface TextOptions {\r\n    /** Text content to render */\r\n    text?: string;\r\n    /** Text color (hex) */\r\n    color?: HexColor;\r\n    /** Text opacity (0-100) */\r\n    opacity?: number;\r\n    /** Background color behind text (hex) */\r\n    background?: HexColor;\r\n    /** Background opacity (0-100) */\r\n    backgroundOpacity?: number;\r\n    /** Text size as percentage of image (1-100) */\r\n    size?: number;\r\n    /** Font family name */\r\n    font?: string;\r\n    /** Font size in pixels */\r\n    fontSize?: number;\r\n    /** Text position */\r\n    position?: Position;\r\n}\r\n\r\n/**\r\n * Watermark options\r\n */\r\nexport interface WatermarkOptions {\r\n    /** Watermark name (predefined in dashboard) */\r\n    name?: string;\r\n    /** Watermark opacity (0-100) */\r\n    opacity?: number;\r\n    /** Watermark size as percentage (1-100) */\r\n    size?: number;\r\n    /** Watermark width in pixels */\r\n    width?: number;\r\n    /** Watermark height in pixels */\r\n    height?: number;\r\n    /** Watermark position */\r\n    position?: Position;\r\n}\r\n\r\n/**\r\n * All transformation options combined\r\n */\r\nexport interface TransformationOptions\r\n    extends ResizeOptions,\r\n        FormatOptions,\r\n        EffectOptions {\r\n    /** Border options */\r\n    border?: BorderOptions;\r\n    /** Crop options */\r\n    crop?: CropOptions;\r\n    /** Text overlay options */\r\n    text?: TextOptions;\r\n    /** Watermark options */\r\n    watermark?: WatermarkOptions;\r\n    /** Use predefined transformation alias */\r\n    alias?: string;\r\n    /** Return original image without transformations */\r\n    original?: boolean;\r\n}\r\n\r\n/**\r\n * Configuration for PixelFiddler client\r\n */\r\nexport interface PixelFiddlerConfig {\r\n    /** Base URL for the CDN (defaults to https://cdn.pixel-fiddler.com) */\r\n    baseUrl?: string;\r\n    /** Secret key for URL signing */\r\n    signatureKey?: string;\r\n}\r\n\r\n/**\r\n * URL builder configuration (internal)\r\n */\r\nexport interface UrlBuilderConfig extends PixelFiddlerConfig {\r\n    /** Resolved base URL */\r\n    baseUrl: string;\r\n}\r\n\r\n/**\r\n * Mapping of transformation options to query parameter names\r\n */\r\nexport interface QueryParameterMapping {\r\n    /** Full parameter name */\r\n    name: string;\r\n    /** Short alias */\r\n    alias?: string;\r\n}\r\n\r\n\r\n","import { Path, PathValue } from './util-types';\r\n\r\nexport const normalizeHex = (value: string) => value.replace('#', '')\r\n\r\n\r\nexport const removeTrailingSlash = (baseUrl: string) => {\r\n    return baseUrl.endsWith('/')\r\n        ? baseUrl.slice(0, -1)\r\n        : baseUrl;\r\n}\r\n\r\nexport const getNestedValue = <\r\n    T,\r\n    P extends Path<T>\r\n>(\r\n    obj: T,\r\n    path: P\r\n): PathValue<T, P> | undefined =>\r\n    path.reduce<any>(\r\n        (acc, key) => (acc == null ? undefined : acc[key]),\r\n        obj\r\n    );\r\n\r\n","import { ParamSpec, Path } from './util-types';\r\nimport { TransformationOptions } from './types';\r\nimport { normalizeHex } from './utils';\r\n\r\nexport const PARAMS = [\r\n    {path: ['width'], long: 'width', short: 'w'},\r\n    {path: ['height'], long: 'height', short: 'h'},\r\n    {path: ['dpr'], long: 'dpr', short: 'dpr'},\r\n    {path: ['mode'], long: 'mode', short: 'rm'},\r\n    {\r\n        path: ['background'],\r\n        long: 'background',\r\n        short: 'bg',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n\r\n    {path: ['format'], long: 'format', short: 'f'},\r\n    {path: ['quality'], long: 'quality', short: 'q'},\r\n    {path: ['stripMetadata'], long: 'stripMetadata', short: 'st'},\r\n\r\n    {path: ['blur'], long: 'blur', short: 'bl'},\r\n    {path: ['brightness'], long: 'brightness', short: 'br'},\r\n    {path: ['contrast'], long: 'contrast', short: 'ct'},\r\n    {path: ['grayscale'], long: 'grayscale', short: 'gs'},\r\n    {path: ['saturation'], long: 'saturation', short: 'sa'},\r\n    {path: ['sepia'], long: 'sepia', short: 'sp'},\r\n    {path: ['sharpen'], long: 'sharpen', short: 'sh'},\r\n    {path: ['noise'], long: 'noise', short: 'ns'},\r\n    {path: ['rotate'], long: 'rotate', short: 'rt'},\r\n\r\n    {path: ['border', 'width'], long: 'border.width', short: 'bo.w'},\r\n    {\r\n        path: ['border', 'color'],\r\n        long: 'border.color',\r\n        short: 'bo.c',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n    {path: ['border', 'radius'], long: 'border.radius', short: 'bo.r'},\r\n\r\n    {path: ['crop', 'type'], long: 'crop.type', short: 'cr.t'},\r\n    {path: ['crop', 'objectType'], long: 'crop.objectType', short: 'cr.o'},\r\n    {path: ['crop', 'focus', 'position', 'x'], long: 'crop.x', short: 'cr.x'},\r\n    {path: ['crop', 'focus', 'position', 'y'], long: 'crop.y', short: 'cr.y'},\r\n    {path: ['crop', 'focus', 'strategy'], long: 'crop', short: 'cr'},\r\n    {path: ['crop', 'width'], long: 'crop.width', short: 'cr.w'},\r\n    {path: ['crop', 'height'], long: 'crop.height', short: 'cr.h'},\r\n    {path: ['crop', 'afterResize'], long: 'crop.afterResize', short: 'cr.ar'},\r\n\r\n    {path: ['text', 'text'], long: 'text', short: 'tx'},\r\n    {\r\n        path: ['text', 'color'],\r\n        long: 'text.color',\r\n        short: 'tx.c',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n    {path: ['text', 'opacity'], long: 'text.opacity', short: 'tx.o'},\r\n    {path: ['text', 'size'], long: 'text.size', short: 'tx.s'},\r\n    {path: ['text', 'font'], long: 'text.font', short: 'tx.f'},\r\n    {path: ['text', 'fontSize'], long: 'text.fontSize', short: 'tx.fs'},\r\n    {path: ['text', 'position'], long: 'text.position', short: 'tx.p'},\r\n    {\r\n        path: ['text', 'background'],\r\n        long: 'text.background',\r\n        short: 'tx.bg',\r\n        normalize: (v) => typeof v === 'string' ? normalizeHex(v) : v\r\n    },\r\n    {path: ['text', 'backgroundOpacity'], long: 'text.backgroundOpacity', short: 'tx.bg.o'},\r\n\r\n    {path: ['watermark', 'name'], long: 'watermark', short: 'wm'},\r\n    {path: ['watermark', 'opacity'], long: 'watermark.opacity', short: 'wm.o'},\r\n    {path: ['watermark', 'size'], long: 'watermark.size', short: 'wm.s'},\r\n    {path: ['watermark', 'width'], long: 'watermark.width', short: 'wm.w'},\r\n    {path: ['watermark', 'height'], long: 'watermark.height', short: 'wm.h'},\r\n    {path: ['watermark', 'position'], long: 'watermark.position', short: 'wm.p'},\r\n] as const satisfies readonly ParamSpec<\r\n    TransformationOptions,\r\n    Path<TransformationOptions>\r\n>[];\r\n","import { TransformationOptions, UrlBuilderConfig } from './types';\r\nimport { getNestedValue, removeTrailingSlash } from './utils';\r\nimport { PARAMS } from './config';\r\n\r\n/**\r\n * Determines which parameter names to use in the query string.\r\n * - `'short'` - Use abbreviated aliases (e.g., `w`, `h`, `q`)\r\n * - `'long'` - Use full parameter names (e.g., `width`, `height`, `quality`)\r\n */\r\ntype NameMode = 'short' | 'long';\r\n\r\n/**\r\n * Converts transformation options into a URL-encoded query string.\r\n *\r\n * Iterates through all defined parameters in the PARAMS config, extracts values\r\n * from the options object using their paths, applies any normalization functions\r\n * (e.g., stripping `#` from hex colors), and returns a URL-encoded query string.\r\n *\r\n * @param options - The transformation options object\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns URL-encoded query string (without leading `?`)\r\n *\r\n * @example\r\n * ```ts\r\n * // Using short aliases (default)\r\n * buildQueryParams({ width: 800, height: 600, quality: 80 });\r\n * // => 'w=800&h=600&q=80'\r\n *\r\n * // Using long parameter names\r\n * buildQueryParams({ width: 800, format: 'webp' }, 'long');\r\n * // => 'width=800&format=webp'\r\n *\r\n * // Nested options\r\n * buildQueryParams({ border: { width: 2, color: '#ff0000' } });\r\n * // => 'bo.w=2&bo.c=ff0000'\r\n * ```\r\n */\r\nexport const buildQueryParams = (\r\n    options: TransformationOptions,\r\n    mode: NameMode = 'short'\r\n): string => {\r\n    const params: Array<[string, string]> = [];\r\n\r\n    for (const spec of PARAMS) {\r\n        const value = getNestedValue(options, spec.path);\r\n        if (value == null) continue;\r\n\r\n        const name =\r\n            mode === 'short' && spec.short ? spec.short : spec.long;\r\n\r\n        let normalized = value\r\n        if ('normalize' in spec) {\r\n            normalized = spec.normalize(value)\r\n        }\r\n\r\n        params.push([name, String(normalized)]);\r\n    }\r\n\r\n\r\n    return new URLSearchParams(\r\n        params.map(([k, v]) => [k, v])\r\n    ).toString();\r\n\r\n};\r\n\r\n/**\r\n * Builds a complete transformation URL from a base URL and transformation options.\r\n *\r\n * Combines the configured base URL with query parameters generated from the\r\n * transformation options. Handles the special `original` flag which returns\r\n * the unmodified source image.\r\n *\r\n * @param config - Configuration containing the base URL for the image\r\n * @param options - The transformation options to apply\r\n * @param mode - Whether to use short aliases or long parameter names (default: `'short'`)\r\n * @returns The complete URL string with query parameters\r\n *\r\n * @example\r\n * ```ts\r\n * const config = { baseUrl: 'https://cdn.example.com/images/photo.jpg' };\r\n *\r\n * // Basic resize\r\n * buildTransformationUrl(config, { width: 400, height: 300 });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=400&h=300'\r\n *\r\n * // Multiple transformations\r\n * buildTransformationUrl(config, {\r\n *   width: 800,\r\n *   format: 'webp',\r\n *   quality: 85,\r\n *   blur: 5\r\n * });\r\n * // => 'https://cdn.example.com/images/photo.jpg?w=800&f=webp&q=85&bl=5'\r\n *\r\n * // Request original image (no transformations)\r\n * buildTransformationUrl(config, { original: true });\r\n * // => 'https://cdn.example.com/images/photo.jpg?original'\r\n *\r\n * // Using long parameter names\r\n * buildTransformationUrl(config, { width: 400 }, 'long');\r\n * // => 'https://cdn.example.com/images/photo.jpg?width=400'\r\n * ```\r\n */\r\nexport const buildTransformationUrl = (\r\n    config: UrlBuilderConfig,\r\n    options: TransformationOptions,\r\n    mode: NameMode = 'short'\r\n) => {\r\n    if (options.original) {\r\n        return `${config.baseUrl}?original`;\r\n    }\r\n\r\n    const query = buildQueryParams(options, mode);\r\n\r\n    const baseUrl = removeTrailingSlash(config.baseUrl)\r\n    return `${baseUrl}?${query}`;\r\n};\r\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@pixelfiddler/core",
+  "version": "0.1.0",
+  "description": "Core utilities for PixelFiddler image transformation SDK",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.18",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "pixelfiddler",
+    "image",
+    "transformation",
+    "cdn",
+    "optimization",
+    "resize",
+    "crop",
+    "webp",
+    "avif"
+  ],
+  "license": "MIT",
+  "author": "PixelFiddler",
+  "homepage": "https://pixel-fiddler.com",
+  "bugs": {
+    "url": "https://github.com/pixelfiddler/js-sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pixelfiddler/js-sdk.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist coverage"
+  }
+}