@useknockout/node 0.0.3 → 0.0.5

package/README.md

@@ -39,19 +39,71 @@ No signup — copy, paste, call the API. Need your own key / production limits?
 import { writeFile } from "node:fs/promises";
 import { Knockout } from "@useknockout/node";
 
-// Public beta — for production use your own key
 const client = new Knockout({ token: "kno_public_beta_4d7e9f1a3c5b2e8d6a9f7c1b3e5d8a2f" });
 
-// 1. From a local file path
+// Remove background — returns transparent PNG buffer
 const png = await client.remove({ file: "./input.jpg" });
-await writeFile("./output.png", png);
+await writeFile("out.png", png);
 
-// 2. From a Buffer (e.g. uploaded via multer)
+// Replace background with a hex color
+const jpg = await client.replaceBackground({
+  file: "./input.jpg",
+  bgColor: "#FF5733",
+  format: "jpg",
+});
+await writeFile("out.jpg", jpg);
+
+// Replace background with a remote image
+const composed = await client.replaceBackground({
+  file: "./input.jpg",
+  bgUrl: "https://example.com/beach.jpg",
+});
+
+// Batch — remove bg from up to 10 URLs in one call
+const batch = await client.removeBatchUrl({
+  urls: ["https://example.com/a.jpg", "https://example.com/b.jpg"],
+});
+for (const r of batch.results) {
+  if (r.success) {
+    await writeFile(`out.png`, Buffer.from(r.data_base64!, "base64"));
+  }
+}
+```
+
+### From a Buffer or remote URL
+
+```ts
+// From a Buffer (e.g. uploaded via multer)
 const buf = await fs.readFile("./input.jpg");
 const out = await client.remove({ file: buf, filename: "input.jpg" });
 
-// 3. From a remote URL
-const url = await client.removeUrl({ url: "https://example.com/cat.jpg" });
+// From a remote URL
+const png = await client.removeUrl({ url: "https://example.com/cat.jpg" });
+```
+
+### New in 0.0.5 — presets
+
+```ts
+// Sticker — thick outline, transparent bg (iMessage / WhatsApp style)
+const sticker = await client.sticker({ file: "./photo.jpg", strokeWidth: 24 });
+
+// Outline — thin stroke around subject
+const outlined = await client.outline({ file: "./photo.jpg", outlineColor: "#000000", outlineWidth: 4 });
+
+// Smart crop — auto-crop to subject bbox + padding
+const cropped = await client.smartCrop({ file: "./photo.jpg", padding: 32 });
+
+// Shadow — drop shadow on a new background
+const withShadow = await client.shadow({ file: "./photo.jpg", bgColor: "#F3F4F6" });
+
+// Studio shot — e-commerce preset (centered subject, white bg, shadow, square)
+const studio = await client.studioShot({ file: "./photo.jpg", aspect: "1:1" });
+
+// Compare — before/after side-by-side image
+const preview = await client.compare({ file: "./photo.jpg" });
+
+// Mask — just the black/white mask for your own pipeline
+const mask = await client.mask({ file: "./photo.jpg" });
 ```
 
 ## API
@@ -88,6 +140,125 @@ Remove the background from a remote image URL.
 
 Returns: `Buffer` of the processed image.
 
+### `client.replaceBackground(input)`
+
+Remove the background and composite the subject onto a new background — solid color or remote image.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `string \| Buffer \| Blob \| ArrayBuffer \| Uint8Array` | Foreground image (path or bytes). |
+| `filename` | `string?` | Optional filename. |
+| `bgColor` | `string?` | Hex color for the new background. Default `"#FFFFFF"`. Ignored if `bgUrl` is set. |
+| `bgUrl` | `string?` | Remote URL of a background image. Takes precedence over `bgColor`. |
+| `format` | `"png" \| "webp" \| "jpg"` | Output format. Default `"png"`. `"jpg"` for smallest file. |
+
+Returns: `Buffer` of the composited image. Edges refined via closed-form foreground matting (no halos).
+
+### `client.removeBatch(input)`
+
+Remove backgrounds from up to 10 images in a single call.
+
+| Field | Type | Description |
+|---|---|---|
+| `files` | `Array<string \| Buffer \| Blob \| ArrayBuffer \| Uint8Array>` | 1–10 file paths or buffers. |
+| `filenames` | `string[]?` | Optional filename aligned to each file. |
+| `format` | `"png" \| "webp"` | Output format. Default `"png"`. |
+
+Returns: `BatchResponse` — `{ count, format, results: [{ filename, success, format, size_bytes, data_base64 | error }] }`. Decode `data_base64` with `Buffer.from(b64, "base64")`.
+
+### `client.removeBatchUrl(input)`
+
+Same as `removeBatch` but takes a JSON array of remote URLs.
+
+| Field | Type | Description |
+|---|---|---|
+| `urls` | `string[]` | 1–10 remote image URLs. |
+| `format` | `"png" \| "webp"` | Output format. Default `"png"`. |
+
+Returns: `BatchResponse` with `url` in place of `filename` in each result.
+
+### `client.mask(input)`
+
+Return just the black/white alpha mask as a grayscale PNG/WebP.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `FileInput` | Image to process. |
+| `format` | `"png" \| "webp"` | Default `"png"`. |
+
+Returns: `Buffer` of a grayscale image (0 = bg, 255 = subject).
+
+### `client.smartCrop(input)`
+
+Auto-crop to the subject's tight bounding box + padding.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `FileInput` | Image to process. |
+| `padding` | `number` | Padding in pixels. Default `24`. |
+| `transparent` | `boolean` | `true` → transparent cutout. `false` → cropped from original. Default `true`. |
+| `format` | `"png" \| "webp" \| "jpg"` | Default `"png"` (or `"jpg"` when `transparent=false`). |
+
+### `client.shadow(input)`
+
+Composite subject onto a new background with a configurable drop shadow.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `FileInput` | Image to process. |
+| `bgColor` | `string` | Hex color. Default `"#FFFFFF"`. |
+| `bgUrl` | `string` | Remote URL. Takes precedence over `bgColor`. |
+| `shadowColor` | `string` | Default `"#000000"`. |
+| `shadowOffsetX` | `number` | Default `8`. |
+| `shadowOffsetY` | `number` | Default `12`. |
+| `shadowBlur` | `number` | Default `14`. |
+| `shadowOpacity` | `number` | 0.0–1.0. Default `0.45`. |
+| `format` | `"png" \| "webp" \| "jpg"` | Default `"png"`. |
+
+### `client.sticker(input)`
+
+Subject with a thick outline on transparent background — sticker style.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `FileInput` | Image to process. |
+| `strokeColor` | `string` | Default `"#FFFFFF"`. |
+| `strokeWidth` | `number` | Pixels. Default `20`, capped at `80`. |
+| `format` | `"png" \| "webp"` | Default `"png"`. |
+
+### `client.outline(input)`
+
+Subject with a thin outline on transparent background.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `FileInput` | Image to process. |
+| `outlineColor` | `string` | Default `"#000000"`. |
+| `outlineWidth` | `number` | Pixels. Default `4`, capped at `60`. |
+| `format` | `"png" \| "webp"` | Default `"png"`. |
+
+### `client.studioShot(input)`
+
+E-commerce preset: cutout + centered on canvas + optional drop shadow + standardized aspect ratio.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `FileInput` | Image to process. |
+| `bgColor` | `string` | Canvas color. Default `"#FFFFFF"`. |
+| `aspect` | `string` | `"W:H"` format, e.g. `"1:1"`, `"4:5"`, `"16:9"`. Default `"1:1"`. |
+| `padding` | `number` | Padding in pixels. Default `48`. |
+| `shadow` | `boolean` | Include drop shadow. Default `true`. |
+| `format` | `"png" \| "webp" \| "jpg"` | Default `"jpg"`. |
+
+### `client.compare(input)`
+
+Before/after side-by-side preview — original on the left, transparent cutout (on a checkerboard) on the right.
+
+| Field | Type | Description |
+|---|---|---|
+| `file` | `FileInput` | Image to process. |
+| `format` | `"png" \| "webp"` | Default `"png"`. |
+
 ### `client.health()`
 
 Returns: `Promise<{ status: string; model: string }>`. No auth required.

package/dist/index.cjs

@@ -7,7 +7,7 @@ var path = require('path');
 
 // src/index.ts
 var DEFAULT_BASE_URL = "https://useknockout--api.modal.run";
-var SDK_VERSION = "0.0.3";
+var SDK_VERSION = "0.0.5";
 var KnockoutError = class _KnockoutError extends Error {
   status;
   code;
@@ -140,6 +140,118 @@ var Knockout = class {
     if (!res.ok) throw new KnockoutError(res.status, await res.text());
     return await res.json();
   }
+  /**
+   * Return only the alpha mask as a grayscale PNG/WebP.
+   * Useful when chaining into your own compositing pipeline.
+   */
+  async mask(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    form.append("format", format);
+    const res = await this.request("POST", "/mask", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Auto-crop to the subject's tight bounding box with configurable padding.
+   * Returns either a transparent cutout or a cropped region from the original image.
+   */
+  async smartCrop(input) {
+    const transparent = input.transparent ?? true;
+    const format = input.format ?? (transparent ? "png" : "jpg");
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    form.append("padding", String(input.padding ?? 24));
+    form.append("transparent", transparent ? "true" : "false");
+    form.append("format", format);
+    const res = await this.request("POST", "/smart-crop", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Composite subject onto a new background with a configurable drop shadow.
+   */
+  async shadow(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.bgColor) form.append("bg_color", input.bgColor);
+    if (input.bgUrl) form.append("bg_url", input.bgUrl);
+    if (input.shadowColor) form.append("shadow_color", input.shadowColor);
+    if (input.shadowOffsetX !== void 0) form.append("shadow_offset_x", String(input.shadowOffsetX));
+    if (input.shadowOffsetY !== void 0) form.append("shadow_offset_y", String(input.shadowOffsetY));
+    if (input.shadowBlur !== void 0) form.append("shadow_blur", String(input.shadowBlur));
+    if (input.shadowOpacity !== void 0) form.append("shadow_opacity", String(input.shadowOpacity));
+    form.append("format", format);
+    const res = await this.request("POST", "/shadow", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Sticker style — subject with a thick outline on transparent background.
+   * Perfect for WhatsApp / iMessage / Telegram stickers.
+   */
+  async sticker(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.strokeColor) form.append("stroke_color", input.strokeColor);
+    if (input.strokeWidth !== void 0) form.append("stroke_width", String(input.strokeWidth));
+    form.append("format", format);
+    const res = await this.request("POST", "/sticker", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Subject on transparent background with a thin configurable outline.
+   */
+  async outline(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.outlineColor) form.append("outline_color", input.outlineColor);
+    if (input.outlineWidth !== void 0) form.append("outline_width", String(input.outlineWidth));
+    form.append("format", format);
+    const res = await this.request("POST", "/outline", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.
+   */
+  async studioShot(input) {
+    const format = input.format ?? "jpg";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.bgColor) form.append("bg_color", input.bgColor);
+    if (input.aspect) form.append("aspect", input.aspect);
+    if (input.padding !== void 0) form.append("padding", String(input.padding));
+    if (input.shadow !== void 0) form.append("shadow", input.shadow ? "true" : "false");
+    form.append("format", format);
+    const res = await this.request("POST", "/studio-shot", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.
+   */
+  async compare(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    form.append("format", format);
+    const res = await this.request("POST", "/compare", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
   /**
    * Remove the background from up to 10 remote image URLs in a single call.
    *

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["readFile","basename"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\n *\n * Quick start:\n *\n *   import { Knockout } from \"@useknockout/node\";\n *\n *   const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\n *   const png = await client.remove({ file: \"./input.jpg\" });   // Buffer of PNG bytes\n *   await writeFile(\"out.png\", png);\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { basename } from \"node:path\";\n\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\nconst SDK_VERSION = \"0.0.3\";\n\nexport type OutputFormat = \"png\" | \"webp\";\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\n\nexport interface KnockoutOptions {\n  /** API bearer token. Required unless your self-hosted instance has no auth. */\n  token?: string;\n  /** Override the API base URL. Defaults to the hosted endpoint. */\n  baseUrl?: string;\n  /** Per-request timeout in milliseconds. Default 60_000. */\n  timeoutMs?: number;\n  /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface RemoveInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface RemoveUrlInput {\n  /** Remote URL of the image to process. */\n  url: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface ReplaceBgInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\n  bgColor?: string;\n  /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\n  bgUrl?: string;\n  /** Output format. \"jpg\" is smallest. Default \"png\". */\n  format?: OpaqueFormat;\n}\n\nexport interface BatchInput {\n  /** Array of local paths / buffers / blobs. Up to 10. */\n  files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\n  /** Optional filenames aligned to `files`. */\n  filenames?: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchUrlInput {\n  /** Remote URLs to process. Up to 10. */\n  urls: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchResultItem {\n  filename?: string;\n  url?: string;\n  success: boolean;\n  format?: OutputFormat;\n  size_bytes?: number;\n  data_base64?: string;\n  error?: string;\n}\n\nexport interface BatchResponse {\n  count: number;\n  format: OutputFormat;\n  results: BatchResultItem[];\n}\n\nexport interface HealthResponse {\n  status: string;\n  model: string;\n}\n\n/**\n * Error thrown when the API returns a non-2xx response.\n */\nexport class KnockoutError extends Error {\n  public readonly status: number;\n  public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\n  public readonly body: string;\n\n  constructor(status: number, body: string) {\n    const code = KnockoutError.classify(status);\n    super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\n    this.name = \"KnockoutError\";\n    this.status = status;\n    this.code = code;\n    this.body = body;\n  }\n\n  private static classify(status: number): KnockoutError[\"code\"] {\n    if (status === 401 || status === 403) return \"auth\";\n    if (status === 429) return \"rate_limit\";\n    if (status === 413) return \"payload_too_large\";\n    if (status >= 400 && status < 500) return \"bad_request\";\n    if (status >= 500) return \"server\";\n    return \"unknown\";\n  }\n}\n\n/**\n * useknockout API client.\n *\n * All methods return a `Buffer` (Node) of the processed image bytes.\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\n */\nexport class Knockout {\n  private readonly baseUrl: string;\n  private readonly token: string | undefined;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: KnockoutOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.token = options.token;\n    this.timeoutMs = options.timeoutMs ?? 60_000;\n    const fetchRef = options.fetch ?? globalThis.fetch;\n    if (!fetchRef) {\n      throw new Error(\n        \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\n      );\n    }\n    this.fetchImpl = fetchRef.bind(globalThis);\n  }\n\n  /** Hit GET /health — no auth required. */\n  async health(): Promise<HealthResponse> {\n    const res = await this.request(\"GET\", \"/health\");\n    const body = await res.text();\n    if (!res.ok) throw new KnockoutError(res.status, body);\n    return JSON.parse(body) as HealthResponse;\n  }\n\n  /**\n   * Remove the background from an image, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.remove({ file: \"./input.jpg\" });\n   */\n  async remove(input: RemoveInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob(input);\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const res = await this.request(\"POST\", `/remove?format=${format}`, {\n      body: form,\n    });\n\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\n   */\n  async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const res = await this.request(\"POST\", \"/remove-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ url: input.url, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Replace the background with a solid color or a remote image.\n   *\n   * @example Solid color\n   *   const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\n   *\n   * @example Remote image as new background\n   *   const png = await client.replaceBackground({\n   *     file: \"./cat.jpg\",\n   *     bgUrl: \"https://example.com/beach.jpg\",\n   *   });\n   */\n  async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const params = new URLSearchParams({ format });\n    if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\n    if (input.bgColor) params.set(\"bg_color\", input.bgColor);\n\n    const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from up to 10 images in a single call.\n   * Returns a JSON object with base64-encoded result bytes per image.\n   *\n   * @example\n   *   const batch = await client.removeBatch({\n   *     files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\n   *     format: \"png\",\n   *   });\n   *   for (const r of batch.results) {\n   *     if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\n   *   }\n   */\n  async removeBatch(input: BatchInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.files.length === 0) throw new Error(\"At least one file required\");\n    if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\n\n    const form = new FormData();\n    for (let i = 0; i < input.files.length; i++) {\n      const name = input.filenames?.[i];\n      const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\n      form.append(\"files\", blob, filename);\n    }\n\n    const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  /**\n   * Remove the background from up to 10 remote image URLs in a single call.\n   *\n   * @example\n   *   const batch = await client.removeBatchUrl({\n   *     urls: [\"https://a.jpg\", \"https://b.jpg\"],\n   *   });\n   */\n  async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.urls.length === 0) throw new Error(\"At least one URL required\");\n    if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\n\n    const res = await this.request(\"POST\", \"/remove-batch-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ urls: input.urls, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  private async request(\n    method: \"GET\" | \"POST\",\n    path: string,\n    init: { headers?: Record<string, string>; body?: BodyInit } = {}\n  ): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\n      ...(init.headers ?? {}),\n    };\n    if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      return await this.fetchImpl(url, {\n        method,\n        headers,\n        body: init.body,\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\nasync function toBlob(\n  input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\n): Promise<{ blob: Blob; filename: string }> {\n  const { file } = input;\n  const filename = input.filename ?? inferFilename(file);\n\n  if (typeof file === \"string\") {\n    const data = await readFile(file);\n    return { blob: new Blob([new Uint8Array(data)]), filename };\n  }\n  if (file instanceof Blob) {\n    return { blob: file, filename };\n  }\n  if (file instanceof ArrayBuffer) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (file instanceof Uint8Array) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (Buffer.isBuffer(file)) {\n    return {\n      blob: new Blob([new Uint8Array(file)]),\n      filename,\n    };\n  }\n  throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\n}\n\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\n  if (typeof file === \"string\") return basename(file) || \"image\";\n  return \"image\";\n}\n\nexport default Knockout;\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["readFile","basename"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\n *\n * Quick start:\n *\n *   import { Knockout } from \"@useknockout/node\";\n *\n *   const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\n *   const png = await client.remove({ file: \"./input.jpg\" });   // Buffer of PNG bytes\n *   await writeFile(\"out.png\", png);\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { basename } from \"node:path\";\n\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\nconst SDK_VERSION = \"0.0.5\";\n\nexport type OutputFormat = \"png\" | \"webp\";\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\n\ntype FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;\n\nexport interface KnockoutOptions {\n  /** API bearer token. Required unless your self-hosted instance has no auth. */\n  token?: string;\n  /** Override the API base URL. Defaults to the hosted endpoint. */\n  baseUrl?: string;\n  /** Per-request timeout in milliseconds. Default 60_000. */\n  timeoutMs?: number;\n  /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface RemoveInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface RemoveUrlInput {\n  /** Remote URL of the image to process. */\n  url: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface ReplaceBgInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\n  bgColor?: string;\n  /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\n  bgUrl?: string;\n  /** Output format. \"jpg\" is smallest. Default \"png\". */\n  format?: OpaqueFormat;\n}\n\nexport interface BatchInput {\n  /** Array of local paths / buffers / blobs. Up to 10. */\n  files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\n  /** Optional filenames aligned to `files`. */\n  filenames?: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchUrlInput {\n  /** Remote URLs to process. Up to 10. */\n  urls: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchResultItem {\n  filename?: string;\n  url?: string;\n  success: boolean;\n  format?: OutputFormat;\n  size_bytes?: number;\n  data_base64?: string;\n  error?: string;\n}\n\nexport interface BatchResponse {\n  count: number;\n  format: OutputFormat;\n  results: BatchResultItem[];\n}\n\nexport interface MaskInput {\n  file: FileInput;\n  filename?: string;\n  format?: OutputFormat;\n}\n\nexport interface SmartCropInput {\n  file: FileInput;\n  filename?: string;\n  /** Padding around the subject bbox, in pixels. Default 24. */\n  padding?: number;\n  /** Return transparent cutout (true) or cropped region from original (false). Default true. */\n  transparent?: boolean;\n  format?: OpaqueFormat;\n}\n\nexport interface ShadowInput {\n  file: FileInput;\n  filename?: string;\n  bgColor?: string;\n  bgUrl?: string;\n  shadowColor?: string;\n  shadowOffsetX?: number;\n  shadowOffsetY?: number;\n  shadowBlur?: number;\n  shadowOpacity?: number;\n  format?: OpaqueFormat;\n}\n\nexport interface StickerInput {\n  file: FileInput;\n  filename?: string;\n  /** Hex color for the outline. Default \"#FFFFFF\". */\n  strokeColor?: string;\n  /** Outline width in pixels. Default 20. */\n  strokeWidth?: number;\n  format?: OutputFormat;\n}\n\nexport interface OutlineInput {\n  file: FileInput;\n  filename?: string;\n  /** Hex color for the outline. Default \"#000000\". */\n  outlineColor?: string;\n  /** Outline width in pixels. Default 4. */\n  outlineWidth?: number;\n  format?: OutputFormat;\n}\n\nexport interface StudioShotInput {\n  file: FileInput;\n  filename?: string;\n  bgColor?: string;\n  /** e.g. \"1:1\", \"4:5\", \"16:9\". Default \"1:1\". */\n  aspect?: string;\n  padding?: number;\n  shadow?: boolean;\n  format?: OpaqueFormat;\n}\n\nexport interface CompareInput {\n  file: FileInput;\n  filename?: string;\n  format?: OutputFormat;\n}\n\nexport interface HealthResponse {\n  status: string;\n  model: string;\n}\n\n/**\n * Error thrown when the API returns a non-2xx response.\n */\nexport class KnockoutError extends Error {\n  public readonly status: number;\n  public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\n  public readonly body: string;\n\n  constructor(status: number, body: string) {\n    const code = KnockoutError.classify(status);\n    super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\n    this.name = \"KnockoutError\";\n    this.status = status;\n    this.code = code;\n    this.body = body;\n  }\n\n  private static classify(status: number): KnockoutError[\"code\"] {\n    if (status === 401 || status === 403) return \"auth\";\n    if (status === 429) return \"rate_limit\";\n    if (status === 413) return \"payload_too_large\";\n    if (status >= 400 && status < 500) return \"bad_request\";\n    if (status >= 500) return \"server\";\n    return \"unknown\";\n  }\n}\n\n/**\n * useknockout API client.\n *\n * All methods return a `Buffer` (Node) of the processed image bytes.\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\n */\nexport class Knockout {\n  private readonly baseUrl: string;\n  private readonly token: string | undefined;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: KnockoutOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.token = options.token;\n    this.timeoutMs = options.timeoutMs ?? 60_000;\n    const fetchRef = options.fetch ?? globalThis.fetch;\n    if (!fetchRef) {\n      throw new Error(\n        \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\n      );\n    }\n    this.fetchImpl = fetchRef.bind(globalThis);\n  }\n\n  /** Hit GET /health — no auth required. */\n  async health(): Promise<HealthResponse> {\n    const res = await this.request(\"GET\", \"/health\");\n    const body = await res.text();\n    if (!res.ok) throw new KnockoutError(res.status, body);\n    return JSON.parse(body) as HealthResponse;\n  }\n\n  /**\n   * Remove the background from an image, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.remove({ file: \"./input.jpg\" });\n   */\n  async remove(input: RemoveInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob(input);\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const res = await this.request(\"POST\", `/remove?format=${format}`, {\n      body: form,\n    });\n\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\n   */\n  async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const res = await this.request(\"POST\", \"/remove-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ url: input.url, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Replace the background with a solid color or a remote image.\n   *\n   * @example Solid color\n   *   const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\n   *\n   * @example Remote image as new background\n   *   const png = await client.replaceBackground({\n   *     file: \"./cat.jpg\",\n   *     bgUrl: \"https://example.com/beach.jpg\",\n   *   });\n   */\n  async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const params = new URLSearchParams({ format });\n    if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\n    if (input.bgColor) params.set(\"bg_color\", input.bgColor);\n\n    const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from up to 10 images in a single call.\n   * Returns a JSON object with base64-encoded result bytes per image.\n   *\n   * @example\n   *   const batch = await client.removeBatch({\n   *     files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\n   *     format: \"png\",\n   *   });\n   *   for (const r of batch.results) {\n   *     if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\n   *   }\n   */\n  async removeBatch(input: BatchInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.files.length === 0) throw new Error(\"At least one file required\");\n    if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\n\n    const form = new FormData();\n    for (let i = 0; i < input.files.length; i++) {\n      const name = input.filenames?.[i];\n      const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\n      form.append(\"files\", blob, filename);\n    }\n\n    const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  /**\n   * Return only the alpha mask as a grayscale PNG/WebP.\n   * Useful when chaining into your own compositing pipeline.\n   */\n  async mask(input: MaskInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/mask\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Auto-crop to the subject's tight bounding box with configurable padding.\n   * Returns either a transparent cutout or a cropped region from the original image.\n   */\n  async smartCrop(input: SmartCropInput): Promise<Buffer> {\n    const transparent = input.transparent ?? true;\n    const format: OpaqueFormat =\n      (input.format as OpaqueFormat | undefined) ?? (transparent ? \"png\" : \"jpg\");\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    form.append(\"padding\", String(input.padding ?? 24));\n    form.append(\"transparent\", transparent ? \"true\" : \"false\");\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/smart-crop\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Composite subject onto a new background with a configurable drop shadow.\n   */\n  async shadow(input: ShadowInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.bgColor) form.append(\"bg_color\", input.bgColor);\n    if (input.bgUrl) form.append(\"bg_url\", input.bgUrl);\n    if (input.shadowColor) form.append(\"shadow_color\", input.shadowColor);\n    if (input.shadowOffsetX !== undefined) form.append(\"shadow_offset_x\", String(input.shadowOffsetX));\n    if (input.shadowOffsetY !== undefined) form.append(\"shadow_offset_y\", String(input.shadowOffsetY));\n    if (input.shadowBlur !== undefined) form.append(\"shadow_blur\", String(input.shadowBlur));\n    if (input.shadowOpacity !== undefined) form.append(\"shadow_opacity\", String(input.shadowOpacity));\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/shadow\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Sticker style — subject with a thick outline on transparent background.\n   * Perfect for WhatsApp / iMessage / Telegram stickers.\n   */\n  async sticker(input: StickerInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.strokeColor) form.append(\"stroke_color\", input.strokeColor);\n    if (input.strokeWidth !== undefined) form.append(\"stroke_width\", String(input.strokeWidth));\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/sticker\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Subject on transparent background with a thin configurable outline.\n   */\n  async outline(input: OutlineInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.outlineColor) form.append(\"outline_color\", input.outlineColor);\n    if (input.outlineWidth !== undefined) form.append(\"outline_width\", String(input.outlineWidth));\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/outline\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.\n   */\n  async studioShot(input: StudioShotInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"jpg\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.bgColor) form.append(\"bg_color\", input.bgColor);\n    if (input.aspect) form.append(\"aspect\", input.aspect);\n    if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\n    if (input.shadow !== undefined) form.append(\"shadow\", input.shadow ? \"true\" : \"false\");\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/studio-shot\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.\n   */\n  async compare(input: CompareInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/compare\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from up to 10 remote image URLs in a single call.\n   *\n   * @example\n   *   const batch = await client.removeBatchUrl({\n   *     urls: [\"https://a.jpg\", \"https://b.jpg\"],\n   *   });\n   */\n  async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.urls.length === 0) throw new Error(\"At least one URL required\");\n    if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\n\n    const res = await this.request(\"POST\", \"/remove-batch-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ urls: input.urls, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  private async request(\n    method: \"GET\" | \"POST\",\n    path: string,\n    init: { headers?: Record<string, string>; body?: BodyInit } = {}\n  ): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\n      ...(init.headers ?? {}),\n    };\n    if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      return await this.fetchImpl(url, {\n        method,\n        headers,\n        body: init.body,\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\nasync function toBlob(\n  input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\n): Promise<{ blob: Blob; filename: string }> {\n  const { file } = input;\n  const filename = input.filename ?? inferFilename(file);\n\n  if (typeof file === \"string\") {\n    const data = await readFile(file);\n    return { blob: new Blob([new Uint8Array(data)]), filename };\n  }\n  if (file instanceof Blob) {\n    return { blob: file, filename };\n  }\n  if (file instanceof ArrayBuffer) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (file instanceof Uint8Array) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (Buffer.isBuffer(file)) {\n    return {\n      blob: new Blob([new Uint8Array(file)]),\n      filename,\n    };\n  }\n  throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\n}\n\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\n  if (typeof file === \"string\") return basename(file) || \"image\";\n  return \"image\";\n}\n\nexport default Knockout;\n"]}

package/dist/index.d.cts

@@ -12,6 +12,7 @@
 declare const DEFAULT_BASE_URL = "https://useknockout--api.modal.run";
 type OutputFormat = "png" | "webp";
 type OpaqueFormat = "png" | "webp" | "jpg";
+type FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;
 interface KnockoutOptions {
     /** API bearer token. Required unless your self-hosted instance has no auth. */
     token?: string;
@@ -76,6 +77,65 @@ interface BatchResponse {
     format: OutputFormat;
     results: BatchResultItem[];
 }
+interface MaskInput {
+    file: FileInput;
+    filename?: string;
+    format?: OutputFormat;
+}
+interface SmartCropInput {
+    file: FileInput;
+    filename?: string;
+    /** Padding around the subject bbox, in pixels. Default 24. */
+    padding?: number;
+    /** Return transparent cutout (true) or cropped region from original (false). Default true. */
+    transparent?: boolean;
+    format?: OpaqueFormat;
+}
+interface ShadowInput {
+    file: FileInput;
+    filename?: string;
+    bgColor?: string;
+    bgUrl?: string;
+    shadowColor?: string;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+    shadowBlur?: number;
+    shadowOpacity?: number;
+    format?: OpaqueFormat;
+}
+interface StickerInput {
+    file: FileInput;
+    filename?: string;
+    /** Hex color for the outline. Default "#FFFFFF". */
+    strokeColor?: string;
+    /** Outline width in pixels. Default 20. */
+    strokeWidth?: number;
+    format?: OutputFormat;
+}
+interface OutlineInput {
+    file: FileInput;
+    filename?: string;
+    /** Hex color for the outline. Default "#000000". */
+    outlineColor?: string;
+    /** Outline width in pixels. Default 4. */
+    outlineWidth?: number;
+    format?: OutputFormat;
+}
+interface StudioShotInput {
+    file: FileInput;
+    filename?: string;
+    bgColor?: string;
+    /** e.g. "1:1", "4:5", "16:9". Default "1:1". */
+    aspect?: string;
+    padding?: number;
+    shadow?: boolean;
+    format?: OpaqueFormat;
+}
+interface CompareInput {
+    file: FileInput;
+    filename?: string;
+    format?: OutputFormat;
+}
 interface HealthResponse {
     status: string;
     model: string;
@@ -145,6 +205,37 @@ declare class Knockout {
      *   }
      */
     removeBatch(input: BatchInput): Promise<BatchResponse>;
+    /**
+     * Return only the alpha mask as a grayscale PNG/WebP.
+     * Useful when chaining into your own compositing pipeline.
+     */
+    mask(input: MaskInput): Promise<Buffer>;
+    /**
+     * Auto-crop to the subject's tight bounding box with configurable padding.
+     * Returns either a transparent cutout or a cropped region from the original image.
+     */
+    smartCrop(input: SmartCropInput): Promise<Buffer>;
+    /**
+     * Composite subject onto a new background with a configurable drop shadow.
+     */
+    shadow(input: ShadowInput): Promise<Buffer>;
+    /**
+     * Sticker style — subject with a thick outline on transparent background.
+     * Perfect for WhatsApp / iMessage / Telegram stickers.
+     */
+    sticker(input: StickerInput): Promise<Buffer>;
+    /**
+     * Subject on transparent background with a thin configurable outline.
+     */
+    outline(input: OutlineInput): Promise<Buffer>;
+    /**
+     * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.
+     */
+    studioShot(input: StudioShotInput): Promise<Buffer>;
+    /**
+     * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.
+     */
+    compare(input: CompareInput): Promise<Buffer>;
     /**
      * Remove the background from up to 10 remote image URLs in a single call.
      *
@@ -157,4 +248,4 @@ declare class Knockout {
     private request;
 }
 
-export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, DEFAULT_BASE_URL, type HealthResponse, Knockout, KnockoutError, type KnockoutOptions, type OpaqueFormat, type OutputFormat, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, Knockout as default };
+export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, type CompareInput, DEFAULT_BASE_URL, type HealthResponse, Knockout, KnockoutError, type KnockoutOptions, type MaskInput, type OpaqueFormat, type OutlineInput, type OutputFormat, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, type ShadowInput, type SmartCropInput, type StickerInput, type StudioShotInput, Knockout as default };

package/dist/index.d.ts

@@ -12,6 +12,7 @@
 declare const DEFAULT_BASE_URL = "https://useknockout--api.modal.run";
 type OutputFormat = "png" | "webp";
 type OpaqueFormat = "png" | "webp" | "jpg";
+type FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;
 interface KnockoutOptions {
     /** API bearer token. Required unless your self-hosted instance has no auth. */
     token?: string;
@@ -76,6 +77,65 @@ interface BatchResponse {
     format: OutputFormat;
     results: BatchResultItem[];
 }
+interface MaskInput {
+    file: FileInput;
+    filename?: string;
+    format?: OutputFormat;
+}
+interface SmartCropInput {
+    file: FileInput;
+    filename?: string;
+    /** Padding around the subject bbox, in pixels. Default 24. */
+    padding?: number;
+    /** Return transparent cutout (true) or cropped region from original (false). Default true. */
+    transparent?: boolean;
+    format?: OpaqueFormat;
+}
+interface ShadowInput {
+    file: FileInput;
+    filename?: string;
+    bgColor?: string;
+    bgUrl?: string;
+    shadowColor?: string;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+    shadowBlur?: number;
+    shadowOpacity?: number;
+    format?: OpaqueFormat;
+}
+interface StickerInput {
+    file: FileInput;
+    filename?: string;
+    /** Hex color for the outline. Default "#FFFFFF". */
+    strokeColor?: string;
+    /** Outline width in pixels. Default 20. */
+    strokeWidth?: number;
+    format?: OutputFormat;
+}
+interface OutlineInput {
+    file: FileInput;
+    filename?: string;
+    /** Hex color for the outline. Default "#000000". */
+    outlineColor?: string;
+    /** Outline width in pixels. Default 4. */
+    outlineWidth?: number;
+    format?: OutputFormat;
+}
+interface StudioShotInput {
+    file: FileInput;
+    filename?: string;
+    bgColor?: string;
+    /** e.g. "1:1", "4:5", "16:9". Default "1:1". */
+    aspect?: string;
+    padding?: number;
+    shadow?: boolean;
+    format?: OpaqueFormat;
+}
+interface CompareInput {
+    file: FileInput;
+    filename?: string;
+    format?: OutputFormat;
+}
 interface HealthResponse {
     status: string;
     model: string;
@@ -145,6 +205,37 @@ declare class Knockout {
      *   }
      */
     removeBatch(input: BatchInput): Promise<BatchResponse>;
+    /**
+     * Return only the alpha mask as a grayscale PNG/WebP.
+     * Useful when chaining into your own compositing pipeline.
+     */
+    mask(input: MaskInput): Promise<Buffer>;
+    /**
+     * Auto-crop to the subject's tight bounding box with configurable padding.
+     * Returns either a transparent cutout or a cropped region from the original image.
+     */
+    smartCrop(input: SmartCropInput): Promise<Buffer>;
+    /**
+     * Composite subject onto a new background with a configurable drop shadow.
+     */
+    shadow(input: ShadowInput): Promise<Buffer>;
+    /**
+     * Sticker style — subject with a thick outline on transparent background.
+     * Perfect for WhatsApp / iMessage / Telegram stickers.
+     */
+    sticker(input: StickerInput): Promise<Buffer>;
+    /**
+     * Subject on transparent background with a thin configurable outline.
+     */
+    outline(input: OutlineInput): Promise<Buffer>;
+    /**
+     * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.
+     */
+    studioShot(input: StudioShotInput): Promise<Buffer>;
+    /**
+     * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.
+     */
+    compare(input: CompareInput): Promise<Buffer>;
     /**
      * Remove the background from up to 10 remote image URLs in a single call.
      *
@@ -157,4 +248,4 @@ declare class Knockout {
     private request;
 }
 
-export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, DEFAULT_BASE_URL, type HealthResponse, Knockout, KnockoutError, type KnockoutOptions, type OpaqueFormat, type OutputFormat, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, Knockout as default };
+export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, type CompareInput, DEFAULT_BASE_URL, type HealthResponse, Knockout, KnockoutError, type KnockoutOptions, type MaskInput, type OpaqueFormat, type OutlineInput, type OutputFormat, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, type ShadowInput, type SmartCropInput, type StickerInput, type StudioShotInput, Knockout as default };

package/dist/index.js

@@ -3,7 +3,7 @@ import { basename } from 'path';
 
 // src/index.ts
 var DEFAULT_BASE_URL = "https://useknockout--api.modal.run";
-var SDK_VERSION = "0.0.3";
+var SDK_VERSION = "0.0.5";
 var KnockoutError = class _KnockoutError extends Error {
   status;
   code;
@@ -136,6 +136,118 @@ var Knockout = class {
     if (!res.ok) throw new KnockoutError(res.status, await res.text());
     return await res.json();
   }
+  /**
+   * Return only the alpha mask as a grayscale PNG/WebP.
+   * Useful when chaining into your own compositing pipeline.
+   */
+  async mask(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    form.append("format", format);
+    const res = await this.request("POST", "/mask", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Auto-crop to the subject's tight bounding box with configurable padding.
+   * Returns either a transparent cutout or a cropped region from the original image.
+   */
+  async smartCrop(input) {
+    const transparent = input.transparent ?? true;
+    const format = input.format ?? (transparent ? "png" : "jpg");
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    form.append("padding", String(input.padding ?? 24));
+    form.append("transparent", transparent ? "true" : "false");
+    form.append("format", format);
+    const res = await this.request("POST", "/smart-crop", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Composite subject onto a new background with a configurable drop shadow.
+   */
+  async shadow(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.bgColor) form.append("bg_color", input.bgColor);
+    if (input.bgUrl) form.append("bg_url", input.bgUrl);
+    if (input.shadowColor) form.append("shadow_color", input.shadowColor);
+    if (input.shadowOffsetX !== void 0) form.append("shadow_offset_x", String(input.shadowOffsetX));
+    if (input.shadowOffsetY !== void 0) form.append("shadow_offset_y", String(input.shadowOffsetY));
+    if (input.shadowBlur !== void 0) form.append("shadow_blur", String(input.shadowBlur));
+    if (input.shadowOpacity !== void 0) form.append("shadow_opacity", String(input.shadowOpacity));
+    form.append("format", format);
+    const res = await this.request("POST", "/shadow", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Sticker style — subject with a thick outline on transparent background.
+   * Perfect for WhatsApp / iMessage / Telegram stickers.
+   */
+  async sticker(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.strokeColor) form.append("stroke_color", input.strokeColor);
+    if (input.strokeWidth !== void 0) form.append("stroke_width", String(input.strokeWidth));
+    form.append("format", format);
+    const res = await this.request("POST", "/sticker", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Subject on transparent background with a thin configurable outline.
+   */
+  async outline(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.outlineColor) form.append("outline_color", input.outlineColor);
+    if (input.outlineWidth !== void 0) form.append("outline_width", String(input.outlineWidth));
+    form.append("format", format);
+    const res = await this.request("POST", "/outline", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.
+   */
+  async studioShot(input) {
+    const format = input.format ?? "jpg";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    if (input.bgColor) form.append("bg_color", input.bgColor);
+    if (input.aspect) form.append("aspect", input.aspect);
+    if (input.padding !== void 0) form.append("padding", String(input.padding));
+    if (input.shadow !== void 0) form.append("shadow", input.shadow ? "true" : "false");
+    form.append("format", format);
+    const res = await this.request("POST", "/studio-shot", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
+  /**
+   * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.
+   */
+  async compare(input) {
+    const format = input.format ?? "png";
+    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
+    const form = new FormData();
+    form.append("file", blob, filename);
+    form.append("format", format);
+    const res = await this.request("POST", "/compare", { body: form });
+    if (!res.ok) throw new KnockoutError(res.status, await res.text());
+    return Buffer.from(await res.arrayBuffer());
+  }
   /**
    * Remove the background from up to 10 remote image URLs in a single call.
    *

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\n *\n * Quick start:\n *\n *   import { Knockout } from \"@useknockout/node\";\n *\n *   const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\n *   const png = await client.remove({ file: \"./input.jpg\" });   // Buffer of PNG bytes\n *   await writeFile(\"out.png\", png);\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { basename } from \"node:path\";\n\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\nconst SDK_VERSION = \"0.0.3\";\n\nexport type OutputFormat = \"png\" | \"webp\";\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\n\nexport interface KnockoutOptions {\n  /** API bearer token. Required unless your self-hosted instance has no auth. */\n  token?: string;\n  /** Override the API base URL. Defaults to the hosted endpoint. */\n  baseUrl?: string;\n  /** Per-request timeout in milliseconds. Default 60_000. */\n  timeoutMs?: number;\n  /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface RemoveInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface RemoveUrlInput {\n  /** Remote URL of the image to process. */\n  url: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface ReplaceBgInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\n  bgColor?: string;\n  /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\n  bgUrl?: string;\n  /** Output format. \"jpg\" is smallest. Default \"png\". */\n  format?: OpaqueFormat;\n}\n\nexport interface BatchInput {\n  /** Array of local paths / buffers / blobs. Up to 10. */\n  files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\n  /** Optional filenames aligned to `files`. */\n  filenames?: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchUrlInput {\n  /** Remote URLs to process. Up to 10. */\n  urls: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchResultItem {\n  filename?: string;\n  url?: string;\n  success: boolean;\n  format?: OutputFormat;\n  size_bytes?: number;\n  data_base64?: string;\n  error?: string;\n}\n\nexport interface BatchResponse {\n  count: number;\n  format: OutputFormat;\n  results: BatchResultItem[];\n}\n\nexport interface HealthResponse {\n  status: string;\n  model: string;\n}\n\n/**\n * Error thrown when the API returns a non-2xx response.\n */\nexport class KnockoutError extends Error {\n  public readonly status: number;\n  public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\n  public readonly body: string;\n\n  constructor(status: number, body: string) {\n    const code = KnockoutError.classify(status);\n    super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\n    this.name = \"KnockoutError\";\n    this.status = status;\n    this.code = code;\n    this.body = body;\n  }\n\n  private static classify(status: number): KnockoutError[\"code\"] {\n    if (status === 401 || status === 403) return \"auth\";\n    if (status === 429) return \"rate_limit\";\n    if (status === 413) return \"payload_too_large\";\n    if (status >= 400 && status < 500) return \"bad_request\";\n    if (status >= 500) return \"server\";\n    return \"unknown\";\n  }\n}\n\n/**\n * useknockout API client.\n *\n * All methods return a `Buffer` (Node) of the processed image bytes.\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\n */\nexport class Knockout {\n  private readonly baseUrl: string;\n  private readonly token: string | undefined;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: KnockoutOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.token = options.token;\n    this.timeoutMs = options.timeoutMs ?? 60_000;\n    const fetchRef = options.fetch ?? globalThis.fetch;\n    if (!fetchRef) {\n      throw new Error(\n        \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\n      );\n    }\n    this.fetchImpl = fetchRef.bind(globalThis);\n  }\n\n  /** Hit GET /health — no auth required. */\n  async health(): Promise<HealthResponse> {\n    const res = await this.request(\"GET\", \"/health\");\n    const body = await res.text();\n    if (!res.ok) throw new KnockoutError(res.status, body);\n    return JSON.parse(body) as HealthResponse;\n  }\n\n  /**\n   * Remove the background from an image, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.remove({ file: \"./input.jpg\" });\n   */\n  async remove(input: RemoveInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob(input);\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const res = await this.request(\"POST\", `/remove?format=${format}`, {\n      body: form,\n    });\n\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\n   */\n  async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const res = await this.request(\"POST\", \"/remove-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ url: input.url, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Replace the background with a solid color or a remote image.\n   *\n   * @example Solid color\n   *   const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\n   *\n   * @example Remote image as new background\n   *   const png = await client.replaceBackground({\n   *     file: \"./cat.jpg\",\n   *     bgUrl: \"https://example.com/beach.jpg\",\n   *   });\n   */\n  async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const params = new URLSearchParams({ format });\n    if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\n    if (input.bgColor) params.set(\"bg_color\", input.bgColor);\n\n    const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from up to 10 images in a single call.\n   * Returns a JSON object with base64-encoded result bytes per image.\n   *\n   * @example\n   *   const batch = await client.removeBatch({\n   *     files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\n   *     format: \"png\",\n   *   });\n   *   for (const r of batch.results) {\n   *     if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\n   *   }\n   */\n  async removeBatch(input: BatchInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.files.length === 0) throw new Error(\"At least one file required\");\n    if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\n\n    const form = new FormData();\n    for (let i = 0; i < input.files.length; i++) {\n      const name = input.filenames?.[i];\n      const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\n      form.append(\"files\", blob, filename);\n    }\n\n    const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  /**\n   * Remove the background from up to 10 remote image URLs in a single call.\n   *\n   * @example\n   *   const batch = await client.removeBatchUrl({\n   *     urls: [\"https://a.jpg\", \"https://b.jpg\"],\n   *   });\n   */\n  async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.urls.length === 0) throw new Error(\"At least one URL required\");\n    if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\n\n    const res = await this.request(\"POST\", \"/remove-batch-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ urls: input.urls, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  private async request(\n    method: \"GET\" | \"POST\",\n    path: string,\n    init: { headers?: Record<string, string>; body?: BodyInit } = {}\n  ): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\n      ...(init.headers ?? {}),\n    };\n    if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      return await this.fetchImpl(url, {\n        method,\n        headers,\n        body: init.body,\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\nasync function toBlob(\n  input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\n): Promise<{ blob: Blob; filename: string }> {\n  const { file } = input;\n  const filename = input.filename ?? inferFilename(file);\n\n  if (typeof file === \"string\") {\n    const data = await readFile(file);\n    return { blob: new Blob([new Uint8Array(data)]), filename };\n  }\n  if (file instanceof Blob) {\n    return { blob: file, filename };\n  }\n  if (file instanceof ArrayBuffer) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (file instanceof Uint8Array) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (Buffer.isBuffer(file)) {\n    return {\n      blob: new Blob([new Uint8Array(file)]),\n      filename,\n    };\n  }\n  throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\n}\n\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\n  if (typeof file === \"string\") return basename(file) || \"image\";\n  return \"image\";\n}\n\nexport default Knockout;\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\n *\n * Quick start:\n *\n *   import { Knockout } from \"@useknockout/node\";\n *\n *   const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\n *   const png = await client.remove({ file: \"./input.jpg\" });   // Buffer of PNG bytes\n *   await writeFile(\"out.png\", png);\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { basename } from \"node:path\";\n\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\nconst SDK_VERSION = \"0.0.5\";\n\nexport type OutputFormat = \"png\" | \"webp\";\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\n\ntype FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;\n\nexport interface KnockoutOptions {\n  /** API bearer token. Required unless your self-hosted instance has no auth. */\n  token?: string;\n  /** Override the API base URL. Defaults to the hosted endpoint. */\n  baseUrl?: string;\n  /** Per-request timeout in milliseconds. Default 60_000. */\n  timeoutMs?: number;\n  /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface RemoveInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface RemoveUrlInput {\n  /** Remote URL of the image to process. */\n  url: string;\n  /** Output format. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface ReplaceBgInput {\n  /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\n  file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\n  /** Optional filename — inferred from path when `file` is a string. */\n  filename?: string;\n  /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\n  bgColor?: string;\n  /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\n  bgUrl?: string;\n  /** Output format. \"jpg\" is smallest. Default \"png\". */\n  format?: OpaqueFormat;\n}\n\nexport interface BatchInput {\n  /** Array of local paths / buffers / blobs. Up to 10. */\n  files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\n  /** Optional filenames aligned to `files`. */\n  filenames?: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchUrlInput {\n  /** Remote URLs to process. Up to 10. */\n  urls: string[];\n  /** Output format for each image. Default \"png\". */\n  format?: OutputFormat;\n}\n\nexport interface BatchResultItem {\n  filename?: string;\n  url?: string;\n  success: boolean;\n  format?: OutputFormat;\n  size_bytes?: number;\n  data_base64?: string;\n  error?: string;\n}\n\nexport interface BatchResponse {\n  count: number;\n  format: OutputFormat;\n  results: BatchResultItem[];\n}\n\nexport interface MaskInput {\n  file: FileInput;\n  filename?: string;\n  format?: OutputFormat;\n}\n\nexport interface SmartCropInput {\n  file: FileInput;\n  filename?: string;\n  /** Padding around the subject bbox, in pixels. Default 24. */\n  padding?: number;\n  /** Return transparent cutout (true) or cropped region from original (false). Default true. */\n  transparent?: boolean;\n  format?: OpaqueFormat;\n}\n\nexport interface ShadowInput {\n  file: FileInput;\n  filename?: string;\n  bgColor?: string;\n  bgUrl?: string;\n  shadowColor?: string;\n  shadowOffsetX?: number;\n  shadowOffsetY?: number;\n  shadowBlur?: number;\n  shadowOpacity?: number;\n  format?: OpaqueFormat;\n}\n\nexport interface StickerInput {\n  file: FileInput;\n  filename?: string;\n  /** Hex color for the outline. Default \"#FFFFFF\". */\n  strokeColor?: string;\n  /** Outline width in pixels. Default 20. */\n  strokeWidth?: number;\n  format?: OutputFormat;\n}\n\nexport interface OutlineInput {\n  file: FileInput;\n  filename?: string;\n  /** Hex color for the outline. Default \"#000000\". */\n  outlineColor?: string;\n  /** Outline width in pixels. Default 4. */\n  outlineWidth?: number;\n  format?: OutputFormat;\n}\n\nexport interface StudioShotInput {\n  file: FileInput;\n  filename?: string;\n  bgColor?: string;\n  /** e.g. \"1:1\", \"4:5\", \"16:9\". Default \"1:1\". */\n  aspect?: string;\n  padding?: number;\n  shadow?: boolean;\n  format?: OpaqueFormat;\n}\n\nexport interface CompareInput {\n  file: FileInput;\n  filename?: string;\n  format?: OutputFormat;\n}\n\nexport interface HealthResponse {\n  status: string;\n  model: string;\n}\n\n/**\n * Error thrown when the API returns a non-2xx response.\n */\nexport class KnockoutError extends Error {\n  public readonly status: number;\n  public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\n  public readonly body: string;\n\n  constructor(status: number, body: string) {\n    const code = KnockoutError.classify(status);\n    super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\n    this.name = \"KnockoutError\";\n    this.status = status;\n    this.code = code;\n    this.body = body;\n  }\n\n  private static classify(status: number): KnockoutError[\"code\"] {\n    if (status === 401 || status === 403) return \"auth\";\n    if (status === 429) return \"rate_limit\";\n    if (status === 413) return \"payload_too_large\";\n    if (status >= 400 && status < 500) return \"bad_request\";\n    if (status >= 500) return \"server\";\n    return \"unknown\";\n  }\n}\n\n/**\n * useknockout API client.\n *\n * All methods return a `Buffer` (Node) of the processed image bytes.\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\n */\nexport class Knockout {\n  private readonly baseUrl: string;\n  private readonly token: string | undefined;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: KnockoutOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.token = options.token;\n    this.timeoutMs = options.timeoutMs ?? 60_000;\n    const fetchRef = options.fetch ?? globalThis.fetch;\n    if (!fetchRef) {\n      throw new Error(\n        \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\n      );\n    }\n    this.fetchImpl = fetchRef.bind(globalThis);\n  }\n\n  /** Hit GET /health — no auth required. */\n  async health(): Promise<HealthResponse> {\n    const res = await this.request(\"GET\", \"/health\");\n    const body = await res.text();\n    if (!res.ok) throw new KnockoutError(res.status, body);\n    return JSON.parse(body) as HealthResponse;\n  }\n\n  /**\n   * Remove the background from an image, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.remove({ file: \"./input.jpg\" });\n   */\n  async remove(input: RemoveInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob(input);\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const res = await this.request(\"POST\", `/remove?format=${format}`, {\n      body: form,\n    });\n\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\n   *\n   * @example\n   *   const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\n   */\n  async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const res = await this.request(\"POST\", \"/remove-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ url: input.url, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Replace the background with a solid color or a remote image.\n   *\n   * @example Solid color\n   *   const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\n   *\n   * @example Remote image as new background\n   *   const png = await client.replaceBackground({\n   *     file: \"./cat.jpg\",\n   *     bgUrl: \"https://example.com/beach.jpg\",\n   *   });\n   */\n  async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n\n    const params = new URLSearchParams({ format });\n    if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\n    if (input.bgColor) params.set(\"bg_color\", input.bgColor);\n\n    const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from up to 10 images in a single call.\n   * Returns a JSON object with base64-encoded result bytes per image.\n   *\n   * @example\n   *   const batch = await client.removeBatch({\n   *     files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\n   *     format: \"png\",\n   *   });\n   *   for (const r of batch.results) {\n   *     if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\n   *   }\n   */\n  async removeBatch(input: BatchInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.files.length === 0) throw new Error(\"At least one file required\");\n    if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\n\n    const form = new FormData();\n    for (let i = 0; i < input.files.length; i++) {\n      const name = input.filenames?.[i];\n      const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\n      form.append(\"files\", blob, filename);\n    }\n\n    const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\n      body: form,\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  /**\n   * Return only the alpha mask as a grayscale PNG/WebP.\n   * Useful when chaining into your own compositing pipeline.\n   */\n  async mask(input: MaskInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/mask\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Auto-crop to the subject's tight bounding box with configurable padding.\n   * Returns either a transparent cutout or a cropped region from the original image.\n   */\n  async smartCrop(input: SmartCropInput): Promise<Buffer> {\n    const transparent = input.transparent ?? true;\n    const format: OpaqueFormat =\n      (input.format as OpaqueFormat | undefined) ?? (transparent ? \"png\" : \"jpg\");\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    form.append(\"padding\", String(input.padding ?? 24));\n    form.append(\"transparent\", transparent ? \"true\" : \"false\");\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/smart-crop\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Composite subject onto a new background with a configurable drop shadow.\n   */\n  async shadow(input: ShadowInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.bgColor) form.append(\"bg_color\", input.bgColor);\n    if (input.bgUrl) form.append(\"bg_url\", input.bgUrl);\n    if (input.shadowColor) form.append(\"shadow_color\", input.shadowColor);\n    if (input.shadowOffsetX !== undefined) form.append(\"shadow_offset_x\", String(input.shadowOffsetX));\n    if (input.shadowOffsetY !== undefined) form.append(\"shadow_offset_y\", String(input.shadowOffsetY));\n    if (input.shadowBlur !== undefined) form.append(\"shadow_blur\", String(input.shadowBlur));\n    if (input.shadowOpacity !== undefined) form.append(\"shadow_opacity\", String(input.shadowOpacity));\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/shadow\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Sticker style — subject with a thick outline on transparent background.\n   * Perfect for WhatsApp / iMessage / Telegram stickers.\n   */\n  async sticker(input: StickerInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.strokeColor) form.append(\"stroke_color\", input.strokeColor);\n    if (input.strokeWidth !== undefined) form.append(\"stroke_width\", String(input.strokeWidth));\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/sticker\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Subject on transparent background with a thin configurable outline.\n   */\n  async outline(input: OutlineInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.outlineColor) form.append(\"outline_color\", input.outlineColor);\n    if (input.outlineWidth !== undefined) form.append(\"outline_width\", String(input.outlineWidth));\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/outline\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.\n   */\n  async studioShot(input: StudioShotInput): Promise<Buffer> {\n    const format: OpaqueFormat = input.format ?? \"jpg\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    if (input.bgColor) form.append(\"bg_color\", input.bgColor);\n    if (input.aspect) form.append(\"aspect\", input.aspect);\n    if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\n    if (input.shadow !== undefined) form.append(\"shadow\", input.shadow ? \"true\" : \"false\");\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/studio-shot\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.\n   */\n  async compare(input: CompareInput): Promise<Buffer> {\n    const format: OutputFormat = input.format ?? \"png\";\n    const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\n    const form = new FormData();\n    form.append(\"file\", blob, filename);\n    form.append(\"format\", format);\n    const res = await this.request(\"POST\", \"/compare\", { body: form });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return Buffer.from(await res.arrayBuffer());\n  }\n\n  /**\n   * Remove the background from up to 10 remote image URLs in a single call.\n   *\n   * @example\n   *   const batch = await client.removeBatchUrl({\n   *     urls: [\"https://a.jpg\", \"https://b.jpg\"],\n   *   });\n   */\n  async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\n    const format: OutputFormat = input.format ?? \"png\";\n    if (input.urls.length === 0) throw new Error(\"At least one URL required\");\n    if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\n\n    const res = await this.request(\"POST\", \"/remove-batch-url\", {\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ urls: input.urls, format }),\n    });\n    if (!res.ok) throw new KnockoutError(res.status, await res.text());\n    return (await res.json()) as BatchResponse;\n  }\n\n  private async request(\n    method: \"GET\" | \"POST\",\n    path: string,\n    init: { headers?: Record<string, string>; body?: BodyInit } = {}\n  ): Promise<Response> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\n      ...(init.headers ?? {}),\n    };\n    if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n    try {\n      return await this.fetchImpl(url, {\n        method,\n        headers,\n        body: init.body,\n        signal: controller.signal,\n      });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\nasync function toBlob(\n  input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\n): Promise<{ blob: Blob; filename: string }> {\n  const { file } = input;\n  const filename = input.filename ?? inferFilename(file);\n\n  if (typeof file === \"string\") {\n    const data = await readFile(file);\n    return { blob: new Blob([new Uint8Array(data)]), filename };\n  }\n  if (file instanceof Blob) {\n    return { blob: file, filename };\n  }\n  if (file instanceof ArrayBuffer) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (file instanceof Uint8Array) {\n    return { blob: new Blob([new Uint8Array(file)]), filename };\n  }\n  if (Buffer.isBuffer(file)) {\n    return {\n      blob: new Blob([new Uint8Array(file)]),\n      filename,\n    };\n  }\n  throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\n}\n\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\n  if (typeof file === \"string\") return basename(file) || \"image\";\n  return \"image\";\n}\n\nexport default Knockout;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useknockout/node",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Official Node.js client for useknockout — state-of-the-art background removal API.",
   "keywords": [
     "background-removal",