@useknockout/node 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -7,7 +7,7 @@ var path = require('path');
7
7
 
8
8
  // src/index.ts
9
9
  var DEFAULT_BASE_URL = "https://useknockout--api.modal.run";
10
- var SDK_VERSION = "0.1.0";
10
+ var SDK_VERSION = "0.2.0";
11
11
  var KnockoutError = class _KnockoutError extends Error {
12
12
  status;
13
13
  code;
@@ -383,6 +383,73 @@ var Knockout = class {
383
383
  if (!res.ok) throw new KnockoutError(res.status, await res.text());
384
384
  return Buffer.from(await res.arrayBuffer());
385
385
  }
386
+ /**
387
+ * Inpaint a region of an image using LaMa (Apache-2.0). Three modes,
388
+ * auto-detected from what you pass:
389
+ *
390
+ * 1. **auto-subject** — pass only `file`. BiRefNet derives the subject
391
+ * mask, inverts it, and LaMa fills the subject region with plausible
392
+ * background. Drop in a photo, get the subject erased.
393
+ * 2. **mask** — pass `file` + `mask` (any image, white = inpaint).
394
+ * 3. **bbox** — pass `file` + `bbox: { x, y, w, h }`. Rectangular region.
395
+ *
396
+ * `dilation` (0..32, default 8) expands the mask before LaMa runs to
397
+ * reduce ghost outlines from tight masks.
398
+ *
399
+ * @example Auto-erase subject
400
+ * const png = await client.inpaint({ file: "./photo.jpg" });
401
+ *
402
+ * @example Erase a rectangular region
403
+ * const png = await client.inpaint({ file: "./photo.jpg", bbox: { x: 100, y: 100, w: 300, h: 400 } });
404
+ */
405
+ async inpaint(input) {
406
+ const format = input.format ?? "png";
407
+ const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
408
+ const form = new FormData();
409
+ form.append("file", blob, filename);
410
+ if (input.mask !== void 0) {
411
+ const { blob: maskBlob, filename: maskFilename } = await toBlob({
412
+ file: input.mask,
413
+ filename: input.maskFilename ?? "mask.png"
414
+ });
415
+ form.append("mask", maskBlob, maskFilename);
416
+ }
417
+ if (input.bbox) {
418
+ form.append("x", String(input.bbox.x));
419
+ form.append("y", String(input.bbox.y));
420
+ form.append("w", String(input.bbox.w));
421
+ form.append("h", String(input.bbox.h));
422
+ }
423
+ if (input.dilation !== void 0) form.append("dilation", String(input.dilation));
424
+ form.append("format", format);
425
+ const res = await this.request("POST", "/inpaint", { body: form });
426
+ if (!res.ok) throw new KnockoutError(res.status, await res.text());
427
+ return Buffer.from(await res.arrayBuffer());
428
+ }
429
+ /**
430
+ * Two-tone silhouette portrait — subject in one solid color, bg in another.
431
+ * Apple Music / Spotify avatar aesthetic. Reuses BiRefNet mask path; no new
432
+ * model load, fast.
433
+ *
434
+ * @example
435
+ * const png = await client.silhouette({
436
+ * file: "./portrait.jpg",
437
+ * subjectColor: "#1E2960",
438
+ * bgColor: "#F0857C",
439
+ * });
440
+ */
441
+ async silhouette(input) {
442
+ const format = input.format ?? "png";
443
+ const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
444
+ const form = new FormData();
445
+ form.append("file", blob, filename);
446
+ if (input.subjectColor) form.append("subject_color", input.subjectColor);
447
+ if (input.bgColor) form.append("bg_color", input.bgColor);
448
+ form.append("format", format);
449
+ const res = await this.request("POST", "/silhouette", { body: form });
450
+ if (!res.ok) throw new KnockoutError(res.status, await res.text());
451
+ return Buffer.from(await res.arrayBuffer());
452
+ }
386
453
  /**
387
454
  * Remove the background from up to 10 remote image URLs in a single call.
388
455
  *
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"names":["readFile","basename"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\r\n *\r\n * Quick start:\r\n *\r\n * import { Knockout } from \"@useknockout/node\";\r\n *\r\n * const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\r\n * const png = await client.remove({ file: \"./input.jpg\" }); // Buffer of PNG bytes\r\n * await writeFile(\"out.png\", png);\r\n */\r\n\r\nimport { readFile } from \"node:fs/promises\";\r\nimport { basename } from \"node:path\";\r\n\r\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\r\nconst SDK_VERSION = \"0.1.0\";\r\n\r\nexport type OutputFormat = \"png\" | \"webp\";\r\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\r\n\r\ntype FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n\r\nexport interface KnockoutOptions {\r\n /** API bearer token. Required unless your self-hosted instance has no auth. */\r\n token?: string;\r\n /** Override the API base URL. Defaults to the hosted endpoint. */\r\n baseUrl?: string;\r\n /** Per-request timeout in milliseconds. Default 60_000. */\r\n timeoutMs?: number;\r\n /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\r\n fetch?: typeof fetch;\r\n}\r\n\r\nexport interface RemoveInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface RemoveUrlInput {\r\n /** Remote URL of the image to process. */\r\n url: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface ReplaceBgInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\r\n bgColor?: string;\r\n /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\r\n bgUrl?: string;\r\n /** Output format. \"jpg\" is smallest. Default \"png\". */\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface BatchInput {\r\n /** Array of local paths / buffers / blobs. Up to 10. */\r\n files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\r\n /** Optional filenames aligned to `files`. */\r\n filenames?: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchUrlInput {\r\n /** Remote URLs to process. Up to 10. */\r\n urls: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchResultItem {\r\n filename?: string;\r\n url?: string;\r\n success: boolean;\r\n format?: OutputFormat;\r\n size_bytes?: number;\r\n data_base64?: string;\r\n error?: string;\r\n}\r\n\r\nexport interface BatchResponse {\r\n count: number;\r\n format: OutputFormat;\r\n results: BatchResultItem[];\r\n}\r\n\r\nexport interface MaskInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface SmartCropInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Padding around the subject bbox, in pixels. Default 24. */\r\n padding?: number;\r\n /** Return transparent cutout (true) or cropped region from original (false). Default true. */\r\n transparent?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ShadowInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n bgUrl?: string;\r\n shadowColor?: string;\r\n shadowOffsetX?: number;\r\n shadowOffsetY?: number;\r\n shadowBlur?: number;\r\n shadowOpacity?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface StickerInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#FFFFFF\". */\r\n strokeColor?: string;\r\n /** Outline width in pixels. Default 20. */\r\n strokeWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface OutlineInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#000000\". */\r\n outlineColor?: string;\r\n /** Outline width in pixels. Default 4. */\r\n outlineWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface StudioShotInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n /** e.g. \"1:1\", \"4:5\", \"16:9\". Default \"1:1\". */\r\n aspect?: string;\r\n padding?: number;\r\n shadow?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface CompareInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface HeadshotInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the background. Default \"#FFFFFF\". Ignored if `bgBlur` is true. */\r\n bgColor?: string;\r\n /** Use a blurred copy of the original image as the background. Default false. */\r\n bgBlur?: boolean;\r\n /** Gaussian blur radius for the background when `bgBlur` is true. Default 20. */\r\n blurRadius?: number;\r\n /** Output aspect \"W:H\". Default \"4:5\" (portrait). */\r\n aspect?: string;\r\n /** Padding around the subject bbox, in pixels. Default 64. */\r\n padding?: number;\r\n /** Vertical headroom as a ratio of canvas height (0–0.5). Default 0.18. */\r\n headTopRatio?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface PreviewInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Long-edge cap in pixels (64–1024). Default 512. */\r\n maxDim?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface UpscaleInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Upscale factor: 2 or 4. Default 4. */\r\n scale?: 2 | 4;\r\n /**\r\n * Backend. `swin2sr` (default, v0.6.0+) is sharper on real photos.\r\n * `realesrgan` is the legacy backend — better on anime/illustrations.\r\n */\r\n model?: \"swin2sr\" | \"realesrgan\";\r\n /** Route through GFPGAN to fix facial detail. Slower, use for portraits. Implies realesrgan. */\r\n faceEnhance?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface FaceRestoreInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Restore only the most prominent face (faster). Default false (all faces). */\r\n onlyCenterFace?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ColorizeInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface EstimateInput {\r\n /** Endpoint name without leading slash, e.g. \"remove\" or \"headshot\". */\r\n endpoint: string;\r\n width: number;\r\n height: number;\r\n}\r\n\r\nexport interface EstimateResponse {\r\n endpoint: string;\r\n image_pixels: number;\r\n est_latency_ms_warm: number;\r\n est_latency_ms_cold: number;\r\n est_cost_usd: number;\r\n free_during_beta: boolean;\r\n note: string;\r\n}\r\n\r\nexport interface StatsDay {\r\n date: string;\r\n count: number;\r\n}\r\n\r\nexport interface StatsResponse {\r\n total_processed: number;\r\n today: number;\r\n last_7_days: StatsDay[];\r\n error?: string;\r\n detail?: string;\r\n}\r\n\r\nexport interface HealthResponse {\r\n status: string;\r\n model: string;\r\n}\r\n\r\n/**\r\n * Error thrown when the API returns a non-2xx response.\r\n */\r\nexport class KnockoutError extends Error {\r\n public readonly status: number;\r\n public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\r\n public readonly body: string;\r\n\r\n constructor(status: number, body: string) {\r\n const code = KnockoutError.classify(status);\r\n super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\r\n this.name = \"KnockoutError\";\r\n this.status = status;\r\n this.code = code;\r\n this.body = body;\r\n }\r\n\r\n private static classify(status: number): KnockoutError[\"code\"] {\r\n if (status === 401 || status === 403) return \"auth\";\r\n if (status === 429) return \"rate_limit\";\r\n if (status === 413) return \"payload_too_large\";\r\n if (status >= 400 && status < 500) return \"bad_request\";\r\n if (status >= 500) return \"server\";\r\n return \"unknown\";\r\n }\r\n}\r\n\r\n/**\r\n * useknockout API client.\r\n *\r\n * All methods return a `Buffer` (Node) of the processed image bytes.\r\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\r\n */\r\nexport class Knockout {\r\n private readonly baseUrl: string;\r\n private readonly token: string | undefined;\r\n private readonly timeoutMs: number;\r\n private readonly fetchImpl: typeof fetch;\r\n\r\n constructor(options: KnockoutOptions = {}) {\r\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\r\n this.token = options.token;\r\n this.timeoutMs = options.timeoutMs ?? 60_000;\r\n const fetchRef = options.fetch ?? globalThis.fetch;\r\n if (!fetchRef) {\r\n throw new Error(\r\n \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\r\n );\r\n }\r\n this.fetchImpl = fetchRef.bind(globalThis);\r\n }\r\n\r\n /** Hit GET /health — no auth required. */\r\n async health(): Promise<HealthResponse> {\r\n const res = await this.request(\"GET\", \"/health\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as HealthResponse;\r\n }\r\n\r\n /**\r\n * Public usage counter — total images processed all-time, today, and a 7-day breakdown.\r\n * Use for landing-page social proof. Eventually consistent across containers.\r\n */\r\n async stats(): Promise<StatsResponse> {\r\n const res = await this.request(\"GET\", \"/stats\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as StatsResponse;\r\n }\r\n\r\n /**\r\n * Predict latency + cost for an endpoint and image size without doing any GPU work.\r\n *\r\n * @example\r\n * const est = await client.estimate({ endpoint: \"remove\", width: 1024, height: 1024 });\r\n */\r\n async estimate(input: EstimateInput): Promise<EstimateResponse> {\r\n const res = await this.request(\"POST\", \"/estimate\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({\r\n endpoint: input.endpoint,\r\n width: input.width,\r\n height: input.height,\r\n }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as EstimateResponse;\r\n }\r\n\r\n /**\r\n * Remove the background from an image, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.remove({ file: \"./input.jpg\" });\r\n */\r\n async remove(input: RemoveInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob(input);\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const res = await this.request(\"POST\", `/remove?format=${format}`, {\r\n body: form,\r\n });\r\n\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\r\n */\r\n async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const res = await this.request(\"POST\", \"/remove-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ url: input.url, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Replace the background with a solid color or a remote image.\r\n *\r\n * @example Solid color\r\n * const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\r\n *\r\n * @example Remote image as new background\r\n * const png = await client.replaceBackground({\r\n * file: \"./cat.jpg\",\r\n * bgUrl: \"https://example.com/beach.jpg\",\r\n * });\r\n */\r\n async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const params = new URLSearchParams({ format });\r\n if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\r\n if (input.bgColor) params.set(\"bg_color\", input.bgColor);\r\n\r\n const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 images in a single call.\r\n * Returns a JSON object with base64-encoded result bytes per image.\r\n *\r\n * @example\r\n * const batch = await client.removeBatch({\r\n * files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\r\n * format: \"png\",\r\n * });\r\n * for (const r of batch.results) {\r\n * if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\r\n * }\r\n */\r\n async removeBatch(input: BatchInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.files.length === 0) throw new Error(\"At least one file required\");\r\n if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\r\n\r\n const form = new FormData();\r\n for (let i = 0; i < input.files.length; i++) {\r\n const name = input.filenames?.[i];\r\n const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\r\n form.append(\"files\", blob, filename);\r\n }\r\n\r\n const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n /**\r\n * Return only the alpha mask as a grayscale PNG/WebP.\r\n * Useful when chaining into your own compositing pipeline.\r\n */\r\n async mask(input: MaskInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/mask\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Auto-crop to the subject's tight bounding box with configurable padding.\r\n * Returns either a transparent cutout or a cropped region from the original image.\r\n */\r\n async smartCrop(input: SmartCropInput): Promise<Buffer> {\r\n const transparent = input.transparent ?? true;\r\n const format: OpaqueFormat =\r\n (input.format as OpaqueFormat | undefined) ?? (transparent ? \"png\" : \"jpg\");\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"padding\", String(input.padding ?? 24));\r\n form.append(\"transparent\", transparent ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/smart-crop\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Composite subject onto a new background with a configurable drop shadow.\r\n */\r\n async shadow(input: ShadowInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgUrl) form.append(\"bg_url\", input.bgUrl);\r\n if (input.shadowColor) form.append(\"shadow_color\", input.shadowColor);\r\n if (input.shadowOffsetX !== undefined) form.append(\"shadow_offset_x\", String(input.shadowOffsetX));\r\n if (input.shadowOffsetY !== undefined) form.append(\"shadow_offset_y\", String(input.shadowOffsetY));\r\n if (input.shadowBlur !== undefined) form.append(\"shadow_blur\", String(input.shadowBlur));\r\n if (input.shadowOpacity !== undefined) form.append(\"shadow_opacity\", String(input.shadowOpacity));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/shadow\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Sticker style — subject with a thick outline on transparent background.\r\n * Perfect for WhatsApp / iMessage / Telegram stickers.\r\n */\r\n async sticker(input: StickerInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.strokeColor) form.append(\"stroke_color\", input.strokeColor);\r\n if (input.strokeWidth !== undefined) form.append(\"stroke_width\", String(input.strokeWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/sticker\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Subject on transparent background with a thin configurable outline.\r\n */\r\n async outline(input: OutlineInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.outlineColor) form.append(\"outline_color\", input.outlineColor);\r\n if (input.outlineWidth !== undefined) form.append(\"outline_width\", String(input.outlineWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/outline\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.\r\n */\r\n async studioShot(input: StudioShotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.shadow !== undefined) form.append(\"shadow\", input.shadow ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/studio-shot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.\r\n */\r\n async compare(input: CompareInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/compare\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * LinkedIn-ready headshot preset — bg removal + portrait crop + center face + bg color or blur.\r\n *\r\n * @example Solid bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgColor: \"#0A0A0A\" });\r\n *\r\n * @example Blurred original as bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgBlur: true, blurRadius: 24 });\r\n */\r\n async headshot(input: HeadshotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgBlur !== undefined) form.append(\"bg_blur\", input.bgBlur ? \"true\" : \"false\");\r\n if (input.blurRadius !== undefined) form.append(\"blur_radius\", String(input.blurRadius));\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.headTopRatio !== undefined) form.append(\"head_top_ratio\", String(input.headTopRatio));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/headshot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Fast low-res preview cutout (~80ms warm). Skips pymatting refinement and downscales\r\n * input to `maxDim` (default 512px on the long edge). Use for UX progress indicators.\r\n */\r\n async preview(input: PreviewInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"max_dim\", String(input.maxDim ?? 512));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/preview\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * 2x / 4x super-resolution. Defaults to Swin2SR (SwinV2 transformer) for sharper\r\n * detail on real photos. Pass `model: \"realesrgan\"` for the legacy backend\r\n * (better on anime / illustrations). `faceEnhance: true` routes portraits\r\n * through GFPGAN.\r\n *\r\n * @example Cutout → 4x upscale (print-ready)\r\n * const png = await client.remove({ file: \"./photo.jpg\" });\r\n * const big = await client.upscale({ file: png, scale: 4 });\r\n */\r\n async upscale(input: UpscaleInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"scale\", String(input.scale ?? 4));\r\n form.append(\"model\", input.model ?? \"swin2sr\");\r\n if (input.faceEnhance !== undefined) {\r\n form.append(\"face_enhance\", input.faceEnhance ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/upscale\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * GFPGAN v1.4 portrait restoration — fix blurry / damaged / low-res faces.\r\n * Background is upscaled 2x by Real-ESRGAN. Pairs with /headshot.\r\n */\r\n async faceRestore(input: FaceRestoreInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.onlyCenterFace !== undefined) {\r\n form.append(\"only_center_face\", input.onlyCenterFace ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/face-restore\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Colorize a black-and-white or grayscale photo (DDColor v0.7.0+).\r\n *\r\n * Apache-2.0 model, single feed-forward (no diffusion), ~500ms warm on L4.\r\n * Works on any input — color photos are converted to grayscale internally\r\n * before color is predicted, which makes round-trip recoloring easy too.\r\n *\r\n * @example\r\n * const buf = await client.colorize({ file: \"./old-photo.jpg\" });\r\n * await writeFile(\"colorized.png\", buf);\r\n */\r\n async colorize(input: ColorizeInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/colorize\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 remote image URLs in a single call.\r\n *\r\n * @example\r\n * const batch = await client.removeBatchUrl({\r\n * urls: [\"https://a.jpg\", \"https://b.jpg\"],\r\n * });\r\n */\r\n async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.urls.length === 0) throw new Error(\"At least one URL required\");\r\n if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\r\n\r\n const res = await this.request(\"POST\", \"/remove-batch-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ urls: input.urls, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n private async request(\r\n method: \"GET\" | \"POST\",\r\n path: string,\r\n init: { headers?: Record<string, string>; body?: BodyInit } = {}\r\n ): Promise<Response> {\r\n const url = `${this.baseUrl}${path}`;\r\n const headers: Record<string, string> = {\r\n \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\r\n ...(init.headers ?? {}),\r\n };\r\n if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\r\n\r\n const controller = new AbortController();\r\n const timer = setTimeout(() => controller.abort(), this.timeoutMs);\r\n try {\r\n return await this.fetchImpl(url, {\r\n method,\r\n headers,\r\n body: init.body,\r\n signal: controller.signal,\r\n });\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n }\r\n}\r\n\r\nasync function toBlob(\r\n input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\r\n): Promise<{ blob: Blob; filename: string }> {\r\n const { file } = input;\r\n const filename = input.filename ?? inferFilename(file);\r\n\r\n if (typeof file === \"string\") {\r\n const data = await readFile(file);\r\n return { blob: new Blob([new Uint8Array(data)]), filename };\r\n }\r\n if (file instanceof Blob) {\r\n return { blob: file, filename };\r\n }\r\n if (file instanceof ArrayBuffer) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (file instanceof Uint8Array) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (Buffer.isBuffer(file)) {\r\n return {\r\n blob: new Blob([new Uint8Array(file)]),\r\n filename,\r\n };\r\n }\r\n throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\r\n}\r\n\r\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\r\n if (typeof file === \"string\") return basename(file) || \"image\";\r\n return \"image\";\r\n}\r\n\r\nexport default Knockout;\r\n"]}
1
+ {"version":3,"sources":["../src/index.ts"],"names":["readFile","basename"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\r\n *\r\n * Quick start:\r\n *\r\n * import { Knockout } from \"@useknockout/node\";\r\n *\r\n * const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\r\n * const png = await client.remove({ file: \"./input.jpg\" }); // Buffer of PNG bytes\r\n * await writeFile(\"out.png\", png);\r\n */\r\n\r\nimport { readFile } from \"node:fs/promises\";\r\nimport { basename } from \"node:path\";\r\n\r\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\r\nconst SDK_VERSION = \"0.2.0\";\r\n\r\nexport type OutputFormat = \"png\" | \"webp\";\r\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\r\n\r\ntype FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n\r\nexport interface KnockoutOptions {\r\n /** API bearer token. Required unless your self-hosted instance has no auth. */\r\n token?: string;\r\n /** Override the API base URL. Defaults to the hosted endpoint. */\r\n baseUrl?: string;\r\n /** Per-request timeout in milliseconds. Default 60_000. */\r\n timeoutMs?: number;\r\n /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\r\n fetch?: typeof fetch;\r\n}\r\n\r\nexport interface RemoveInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface RemoveUrlInput {\r\n /** Remote URL of the image to process. */\r\n url: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface ReplaceBgInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\r\n bgColor?: string;\r\n /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\r\n bgUrl?: string;\r\n /** Output format. \"jpg\" is smallest. Default \"png\". */\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface BatchInput {\r\n /** Array of local paths / buffers / blobs. Up to 10. */\r\n files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\r\n /** Optional filenames aligned to `files`. */\r\n filenames?: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchUrlInput {\r\n /** Remote URLs to process. Up to 10. */\r\n urls: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchResultItem {\r\n filename?: string;\r\n url?: string;\r\n success: boolean;\r\n format?: OutputFormat;\r\n size_bytes?: number;\r\n data_base64?: string;\r\n error?: string;\r\n}\r\n\r\nexport interface BatchResponse {\r\n count: number;\r\n format: OutputFormat;\r\n results: BatchResultItem[];\r\n}\r\n\r\nexport interface MaskInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface SmartCropInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Padding around the subject bbox, in pixels. Default 24. */\r\n padding?: number;\r\n /** Return transparent cutout (true) or cropped region from original (false). Default true. */\r\n transparent?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ShadowInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n bgUrl?: string;\r\n shadowColor?: string;\r\n shadowOffsetX?: number;\r\n shadowOffsetY?: number;\r\n shadowBlur?: number;\r\n shadowOpacity?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface StickerInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#FFFFFF\". */\r\n strokeColor?: string;\r\n /** Outline width in pixels. Default 20. */\r\n strokeWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface OutlineInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#000000\". */\r\n outlineColor?: string;\r\n /** Outline width in pixels. Default 4. */\r\n outlineWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface StudioShotInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n /** e.g. \"1:1\", \"4:5\", \"16:9\". Default \"1:1\". */\r\n aspect?: string;\r\n padding?: number;\r\n shadow?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface CompareInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface HeadshotInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the background. Default \"#FFFFFF\". Ignored if `bgBlur` is true. */\r\n bgColor?: string;\r\n /** Use a blurred copy of the original image as the background. Default false. */\r\n bgBlur?: boolean;\r\n /** Gaussian blur radius for the background when `bgBlur` is true. Default 20. */\r\n blurRadius?: number;\r\n /** Output aspect \"W:H\". Default \"4:5\" (portrait). */\r\n aspect?: string;\r\n /** Padding around the subject bbox, in pixels. Default 64. */\r\n padding?: number;\r\n /** Vertical headroom as a ratio of canvas height (0–0.5). Default 0.18. */\r\n headTopRatio?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface PreviewInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Long-edge cap in pixels (64–1024). Default 512. */\r\n maxDim?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface UpscaleInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Upscale factor: 2 or 4. Default 4. */\r\n scale?: 2 | 4;\r\n /**\r\n * Backend. `swin2sr` (default, v0.6.0+) is sharper on real photos.\r\n * `realesrgan` is the legacy backend — better on anime/illustrations.\r\n */\r\n model?: \"swin2sr\" | \"realesrgan\";\r\n /** Route through GFPGAN to fix facial detail. Slower, use for portraits. Implies realesrgan. */\r\n faceEnhance?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface FaceRestoreInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Restore only the most prominent face (faster). Default false (all faces). */\r\n onlyCenterFace?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ColorizeInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface SilhouetteInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the subject silhouette. Default \"#7C3AED\" (purple). */\r\n subjectColor?: string;\r\n /** Hex color for the background. Default \"#FFFFFF\" (white). */\r\n bgColor?: string;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface InpaintBbox {\r\n x: number;\r\n y: number;\r\n w: number;\r\n h: number;\r\n}\r\n\r\nexport interface InpaintInput {\r\n file: FileInput;\r\n filename?: string;\r\n /**\r\n * Optional mask. White pixels = inpaint, black = keep. If omitted (and no\r\n * `bbox`), auto-subject mode runs BiRefNet on the input and inverts the\r\n * subject mask.\r\n */\r\n mask?: FileInput;\r\n maskFilename?: string;\r\n /** Rectangular region to inpaint. Mutually exclusive with `mask`. */\r\n bbox?: InpaintBbox;\r\n /** Mask dilation in pixels. Default 8, range 0..32. */\r\n dilation?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface EstimateInput {\r\n /** Endpoint name without leading slash, e.g. \"remove\" or \"headshot\". */\r\n endpoint: string;\r\n width: number;\r\n height: number;\r\n}\r\n\r\nexport interface EstimateResponse {\r\n endpoint: string;\r\n image_pixels: number;\r\n est_latency_ms_warm: number;\r\n est_latency_ms_cold: number;\r\n est_cost_usd: number;\r\n free_during_beta: boolean;\r\n note: string;\r\n}\r\n\r\nexport interface StatsDay {\r\n date: string;\r\n count: number;\r\n}\r\n\r\nexport interface StatsResponse {\r\n total_processed: number;\r\n today: number;\r\n last_7_days: StatsDay[];\r\n error?: string;\r\n detail?: string;\r\n}\r\n\r\nexport interface HealthResponse {\r\n status: string;\r\n model: string;\r\n}\r\n\r\n/**\r\n * Error thrown when the API returns a non-2xx response.\r\n */\r\nexport class KnockoutError extends Error {\r\n public readonly status: number;\r\n public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\r\n public readonly body: string;\r\n\r\n constructor(status: number, body: string) {\r\n const code = KnockoutError.classify(status);\r\n super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\r\n this.name = \"KnockoutError\";\r\n this.status = status;\r\n this.code = code;\r\n this.body = body;\r\n }\r\n\r\n private static classify(status: number): KnockoutError[\"code\"] {\r\n if (status === 401 || status === 403) return \"auth\";\r\n if (status === 429) return \"rate_limit\";\r\n if (status === 413) return \"payload_too_large\";\r\n if (status >= 400 && status < 500) return \"bad_request\";\r\n if (status >= 500) return \"server\";\r\n return \"unknown\";\r\n }\r\n}\r\n\r\n/**\r\n * useknockout API client.\r\n *\r\n * All methods return a `Buffer` (Node) of the processed image bytes.\r\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\r\n */\r\nexport class Knockout {\r\n private readonly baseUrl: string;\r\n private readonly token: string | undefined;\r\n private readonly timeoutMs: number;\r\n private readonly fetchImpl: typeof fetch;\r\n\r\n constructor(options: KnockoutOptions = {}) {\r\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\r\n this.token = options.token;\r\n this.timeoutMs = options.timeoutMs ?? 60_000;\r\n const fetchRef = options.fetch ?? globalThis.fetch;\r\n if (!fetchRef) {\r\n throw new Error(\r\n \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\r\n );\r\n }\r\n this.fetchImpl = fetchRef.bind(globalThis);\r\n }\r\n\r\n /** Hit GET /health — no auth required. */\r\n async health(): Promise<HealthResponse> {\r\n const res = await this.request(\"GET\", \"/health\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as HealthResponse;\r\n }\r\n\r\n /**\r\n * Public usage counter — total images processed all-time, today, and a 7-day breakdown.\r\n * Use for landing-page social proof. Eventually consistent across containers.\r\n */\r\n async stats(): Promise<StatsResponse> {\r\n const res = await this.request(\"GET\", \"/stats\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as StatsResponse;\r\n }\r\n\r\n /**\r\n * Predict latency + cost for an endpoint and image size without doing any GPU work.\r\n *\r\n * @example\r\n * const est = await client.estimate({ endpoint: \"remove\", width: 1024, height: 1024 });\r\n */\r\n async estimate(input: EstimateInput): Promise<EstimateResponse> {\r\n const res = await this.request(\"POST\", \"/estimate\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({\r\n endpoint: input.endpoint,\r\n width: input.width,\r\n height: input.height,\r\n }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as EstimateResponse;\r\n }\r\n\r\n /**\r\n * Remove the background from an image, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.remove({ file: \"./input.jpg\" });\r\n */\r\n async remove(input: RemoveInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob(input);\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const res = await this.request(\"POST\", `/remove?format=${format}`, {\r\n body: form,\r\n });\r\n\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\r\n */\r\n async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const res = await this.request(\"POST\", \"/remove-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ url: input.url, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Replace the background with a solid color or a remote image.\r\n *\r\n * @example Solid color\r\n * const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\r\n *\r\n * @example Remote image as new background\r\n * const png = await client.replaceBackground({\r\n * file: \"./cat.jpg\",\r\n * bgUrl: \"https://example.com/beach.jpg\",\r\n * });\r\n */\r\n async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const params = new URLSearchParams({ format });\r\n if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\r\n if (input.bgColor) params.set(\"bg_color\", input.bgColor);\r\n\r\n const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 images in a single call.\r\n * Returns a JSON object with base64-encoded result bytes per image.\r\n *\r\n * @example\r\n * const batch = await client.removeBatch({\r\n * files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\r\n * format: \"png\",\r\n * });\r\n * for (const r of batch.results) {\r\n * if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\r\n * }\r\n */\r\n async removeBatch(input: BatchInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.files.length === 0) throw new Error(\"At least one file required\");\r\n if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\r\n\r\n const form = new FormData();\r\n for (let i = 0; i < input.files.length; i++) {\r\n const name = input.filenames?.[i];\r\n const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\r\n form.append(\"files\", blob, filename);\r\n }\r\n\r\n const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n /**\r\n * Return only the alpha mask as a grayscale PNG/WebP.\r\n * Useful when chaining into your own compositing pipeline.\r\n */\r\n async mask(input: MaskInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/mask\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Auto-crop to the subject's tight bounding box with configurable padding.\r\n * Returns either a transparent cutout or a cropped region from the original image.\r\n */\r\n async smartCrop(input: SmartCropInput): Promise<Buffer> {\r\n const transparent = input.transparent ?? true;\r\n const format: OpaqueFormat =\r\n (input.format as OpaqueFormat | undefined) ?? (transparent ? \"png\" : \"jpg\");\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"padding\", String(input.padding ?? 24));\r\n form.append(\"transparent\", transparent ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/smart-crop\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Composite subject onto a new background with a configurable drop shadow.\r\n */\r\n async shadow(input: ShadowInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgUrl) form.append(\"bg_url\", input.bgUrl);\r\n if (input.shadowColor) form.append(\"shadow_color\", input.shadowColor);\r\n if (input.shadowOffsetX !== undefined) form.append(\"shadow_offset_x\", String(input.shadowOffsetX));\r\n if (input.shadowOffsetY !== undefined) form.append(\"shadow_offset_y\", String(input.shadowOffsetY));\r\n if (input.shadowBlur !== undefined) form.append(\"shadow_blur\", String(input.shadowBlur));\r\n if (input.shadowOpacity !== undefined) form.append(\"shadow_opacity\", String(input.shadowOpacity));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/shadow\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Sticker style — subject with a thick outline on transparent background.\r\n * Perfect for WhatsApp / iMessage / Telegram stickers.\r\n */\r\n async sticker(input: StickerInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.strokeColor) form.append(\"stroke_color\", input.strokeColor);\r\n if (input.strokeWidth !== undefined) form.append(\"stroke_width\", String(input.strokeWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/sticker\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Subject on transparent background with a thin configurable outline.\r\n */\r\n async outline(input: OutlineInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.outlineColor) form.append(\"outline_color\", input.outlineColor);\r\n if (input.outlineWidth !== undefined) form.append(\"outline_width\", String(input.outlineWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/outline\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.\r\n */\r\n async studioShot(input: StudioShotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.shadow !== undefined) form.append(\"shadow\", input.shadow ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/studio-shot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.\r\n */\r\n async compare(input: CompareInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/compare\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * LinkedIn-ready headshot preset — bg removal + portrait crop + center face + bg color or blur.\r\n *\r\n * @example Solid bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgColor: \"#0A0A0A\" });\r\n *\r\n * @example Blurred original as bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgBlur: true, blurRadius: 24 });\r\n */\r\n async headshot(input: HeadshotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgBlur !== undefined) form.append(\"bg_blur\", input.bgBlur ? \"true\" : \"false\");\r\n if (input.blurRadius !== undefined) form.append(\"blur_radius\", String(input.blurRadius));\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.headTopRatio !== undefined) form.append(\"head_top_ratio\", String(input.headTopRatio));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/headshot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Fast low-res preview cutout (~80ms warm). Skips pymatting refinement and downscales\r\n * input to `maxDim` (default 512px on the long edge). Use for UX progress indicators.\r\n */\r\n async preview(input: PreviewInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"max_dim\", String(input.maxDim ?? 512));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/preview\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * 2x / 4x super-resolution. Defaults to Swin2SR (SwinV2 transformer) for sharper\r\n * detail on real photos. Pass `model: \"realesrgan\"` for the legacy backend\r\n * (better on anime / illustrations). `faceEnhance: true` routes portraits\r\n * through GFPGAN.\r\n *\r\n * @example Cutout → 4x upscale (print-ready)\r\n * const png = await client.remove({ file: \"./photo.jpg\" });\r\n * const big = await client.upscale({ file: png, scale: 4 });\r\n */\r\n async upscale(input: UpscaleInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"scale\", String(input.scale ?? 4));\r\n form.append(\"model\", input.model ?? \"swin2sr\");\r\n if (input.faceEnhance !== undefined) {\r\n form.append(\"face_enhance\", input.faceEnhance ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/upscale\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * GFPGAN v1.4 portrait restoration — fix blurry / damaged / low-res faces.\r\n * Background is upscaled 2x by Real-ESRGAN. Pairs with /headshot.\r\n */\r\n async faceRestore(input: FaceRestoreInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.onlyCenterFace !== undefined) {\r\n form.append(\"only_center_face\", input.onlyCenterFace ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/face-restore\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Colorize a black-and-white or grayscale photo (DDColor v0.7.0+).\r\n *\r\n * Apache-2.0 model, single feed-forward (no diffusion), ~500ms warm on L4.\r\n * Works on any input — color photos are converted to grayscale internally\r\n * before color is predicted, which makes round-trip recoloring easy too.\r\n *\r\n * @example\r\n * const buf = await client.colorize({ file: \"./old-photo.jpg\" });\r\n * await writeFile(\"colorized.png\", buf);\r\n */\r\n async colorize(input: ColorizeInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/colorize\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Inpaint a region of an image using LaMa (Apache-2.0). Three modes,\r\n * auto-detected from what you pass:\r\n *\r\n * 1. **auto-subject** — pass only `file`. BiRefNet derives the subject\r\n * mask, inverts it, and LaMa fills the subject region with plausible\r\n * background. Drop in a photo, get the subject erased.\r\n * 2. **mask** — pass `file` + `mask` (any image, white = inpaint).\r\n * 3. **bbox** — pass `file` + `bbox: { x, y, w, h }`. Rectangular region.\r\n *\r\n * `dilation` (0..32, default 8) expands the mask before LaMa runs to\r\n * reduce ghost outlines from tight masks.\r\n *\r\n * @example Auto-erase subject\r\n * const png = await client.inpaint({ file: \"./photo.jpg\" });\r\n *\r\n * @example Erase a rectangular region\r\n * const png = await client.inpaint({ file: \"./photo.jpg\", bbox: { x: 100, y: 100, w: 300, h: 400 } });\r\n */\r\n async inpaint(input: InpaintInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.mask !== undefined) {\r\n const { blob: maskBlob, filename: maskFilename } = await toBlob({\r\n file: input.mask,\r\n filename: input.maskFilename ?? \"mask.png\",\r\n });\r\n form.append(\"mask\", maskBlob, maskFilename);\r\n }\r\n if (input.bbox) {\r\n form.append(\"x\", String(input.bbox.x));\r\n form.append(\"y\", String(input.bbox.y));\r\n form.append(\"w\", String(input.bbox.w));\r\n form.append(\"h\", String(input.bbox.h));\r\n }\r\n if (input.dilation !== undefined) form.append(\"dilation\", String(input.dilation));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/inpaint\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Two-tone silhouette portrait — subject in one solid color, bg in another.\r\n * Apple Music / Spotify avatar aesthetic. Reuses BiRefNet mask path; no new\r\n * model load, fast.\r\n *\r\n * @example\r\n * const png = await client.silhouette({\r\n * file: \"./portrait.jpg\",\r\n * subjectColor: \"#1E2960\",\r\n * bgColor: \"#F0857C\",\r\n * });\r\n */\r\n async silhouette(input: SilhouetteInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.subjectColor) form.append(\"subject_color\", input.subjectColor);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/silhouette\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 remote image URLs in a single call.\r\n *\r\n * @example\r\n * const batch = await client.removeBatchUrl({\r\n * urls: [\"https://a.jpg\", \"https://b.jpg\"],\r\n * });\r\n */\r\n async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.urls.length === 0) throw new Error(\"At least one URL required\");\r\n if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\r\n\r\n const res = await this.request(\"POST\", \"/remove-batch-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ urls: input.urls, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n private async request(\r\n method: \"GET\" | \"POST\",\r\n path: string,\r\n init: { headers?: Record<string, string>; body?: BodyInit } = {}\r\n ): Promise<Response> {\r\n const url = `${this.baseUrl}${path}`;\r\n const headers: Record<string, string> = {\r\n \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\r\n ...(init.headers ?? {}),\r\n };\r\n if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\r\n\r\n const controller = new AbortController();\r\n const timer = setTimeout(() => controller.abort(), this.timeoutMs);\r\n try {\r\n return await this.fetchImpl(url, {\r\n method,\r\n headers,\r\n body: init.body,\r\n signal: controller.signal,\r\n });\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n }\r\n}\r\n\r\nasync function toBlob(\r\n input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\r\n): Promise<{ blob: Blob; filename: string }> {\r\n const { file } = input;\r\n const filename = input.filename ?? inferFilename(file);\r\n\r\n if (typeof file === \"string\") {\r\n const data = await readFile(file);\r\n return { blob: new Blob([new Uint8Array(data)]), filename };\r\n }\r\n if (file instanceof Blob) {\r\n return { blob: file, filename };\r\n }\r\n if (file instanceof ArrayBuffer) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (file instanceof Uint8Array) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (Buffer.isBuffer(file)) {\r\n return {\r\n blob: new Blob([new Uint8Array(file)]),\r\n filename,\r\n };\r\n }\r\n throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\r\n}\r\n\r\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\r\n if (typeof file === \"string\") return basename(file) || \"image\";\r\n return \"image\";\r\n}\r\n\r\nexport default Knockout;\r\n"]}
package/dist/index.d.cts CHANGED
@@ -186,6 +186,37 @@ interface ColorizeInput {
186
186
  filename?: string;
187
187
  format?: OpaqueFormat;
188
188
  }
189
+ interface SilhouetteInput {
190
+ file: FileInput;
191
+ filename?: string;
192
+ /** Hex color for the subject silhouette. Default "#7C3AED" (purple). */
193
+ subjectColor?: string;
194
+ /** Hex color for the background. Default "#FFFFFF" (white). */
195
+ bgColor?: string;
196
+ format?: OpaqueFormat;
197
+ }
198
+ interface InpaintBbox {
199
+ x: number;
200
+ y: number;
201
+ w: number;
202
+ h: number;
203
+ }
204
+ interface InpaintInput {
205
+ file: FileInput;
206
+ filename?: string;
207
+ /**
208
+ * Optional mask. White pixels = inpaint, black = keep. If omitted (and no
209
+ * `bbox`), auto-subject mode runs BiRefNet on the input and inverts the
210
+ * subject mask.
211
+ */
212
+ mask?: FileInput;
213
+ maskFilename?: string;
214
+ /** Rectangular region to inpaint. Mutually exclusive with `mask`. */
215
+ bbox?: InpaintBbox;
216
+ /** Mask dilation in pixels. Default 8, range 0..32. */
217
+ dilation?: number;
218
+ format?: OpaqueFormat;
219
+ }
189
220
  interface EstimateInput {
190
221
  /** Endpoint name without leading slash, e.g. "remove" or "headshot". */
191
222
  endpoint: string;
@@ -367,6 +398,39 @@ declare class Knockout {
367
398
  * await writeFile("colorized.png", buf);
368
399
  */
369
400
  colorize(input: ColorizeInput): Promise<Buffer>;
401
+ /**
402
+ * Inpaint a region of an image using LaMa (Apache-2.0). Three modes,
403
+ * auto-detected from what you pass:
404
+ *
405
+ * 1. **auto-subject** — pass only `file`. BiRefNet derives the subject
406
+ * mask, inverts it, and LaMa fills the subject region with plausible
407
+ * background. Drop in a photo, get the subject erased.
408
+ * 2. **mask** — pass `file` + `mask` (any image, white = inpaint).
409
+ * 3. **bbox** — pass `file` + `bbox: { x, y, w, h }`. Rectangular region.
410
+ *
411
+ * `dilation` (0..32, default 8) expands the mask before LaMa runs to
412
+ * reduce ghost outlines from tight masks.
413
+ *
414
+ * @example Auto-erase subject
415
+ * const png = await client.inpaint({ file: "./photo.jpg" });
416
+ *
417
+ * @example Erase a rectangular region
418
+ * const png = await client.inpaint({ file: "./photo.jpg", bbox: { x: 100, y: 100, w: 300, h: 400 } });
419
+ */
420
+ inpaint(input: InpaintInput): Promise<Buffer>;
421
+ /**
422
+ * Two-tone silhouette portrait — subject in one solid color, bg in another.
423
+ * Apple Music / Spotify avatar aesthetic. Reuses BiRefNet mask path; no new
424
+ * model load, fast.
425
+ *
426
+ * @example
427
+ * const png = await client.silhouette({
428
+ * file: "./portrait.jpg",
429
+ * subjectColor: "#1E2960",
430
+ * bgColor: "#F0857C",
431
+ * });
432
+ */
433
+ silhouette(input: SilhouetteInput): Promise<Buffer>;
370
434
  /**
371
435
  * Remove the background from up to 10 remote image URLs in a single call.
372
436
  *
@@ -379,4 +443,4 @@ declare class Knockout {
379
443
  private request;
380
444
  }
381
445
 
382
- export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, type ColorizeInput, type CompareInput, DEFAULT_BASE_URL, type EstimateInput, type EstimateResponse, type FaceRestoreInput, type HeadshotInput, type HealthResponse, Knockout, KnockoutError, type KnockoutOptions, type MaskInput, type OpaqueFormat, type OutlineInput, type OutputFormat, type PreviewInput, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, type ShadowInput, type SmartCropInput, type StatsDay, type StatsResponse, type StickerInput, type StudioShotInput, type UpscaleInput, Knockout as default };
446
+ export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, type ColorizeInput, type CompareInput, DEFAULT_BASE_URL, type EstimateInput, type EstimateResponse, type FaceRestoreInput, type HeadshotInput, type HealthResponse, type InpaintBbox, type InpaintInput, Knockout, KnockoutError, type KnockoutOptions, type MaskInput, type OpaqueFormat, type OutlineInput, type OutputFormat, type PreviewInput, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, type ShadowInput, type SilhouetteInput, type SmartCropInput, type StatsDay, type StatsResponse, type StickerInput, type StudioShotInput, type UpscaleInput, Knockout as default };
package/dist/index.d.ts CHANGED
@@ -186,6 +186,37 @@ interface ColorizeInput {
186
186
  filename?: string;
187
187
  format?: OpaqueFormat;
188
188
  }
189
+ interface SilhouetteInput {
190
+ file: FileInput;
191
+ filename?: string;
192
+ /** Hex color for the subject silhouette. Default "#7C3AED" (purple). */
193
+ subjectColor?: string;
194
+ /** Hex color for the background. Default "#FFFFFF" (white). */
195
+ bgColor?: string;
196
+ format?: OpaqueFormat;
197
+ }
198
+ interface InpaintBbox {
199
+ x: number;
200
+ y: number;
201
+ w: number;
202
+ h: number;
203
+ }
204
+ interface InpaintInput {
205
+ file: FileInput;
206
+ filename?: string;
207
+ /**
208
+ * Optional mask. White pixels = inpaint, black = keep. If omitted (and no
209
+ * `bbox`), auto-subject mode runs BiRefNet on the input and inverts the
210
+ * subject mask.
211
+ */
212
+ mask?: FileInput;
213
+ maskFilename?: string;
214
+ /** Rectangular region to inpaint. Mutually exclusive with `mask`. */
215
+ bbox?: InpaintBbox;
216
+ /** Mask dilation in pixels. Default 8, range 0..32. */
217
+ dilation?: number;
218
+ format?: OpaqueFormat;
219
+ }
189
220
  interface EstimateInput {
190
221
  /** Endpoint name without leading slash, e.g. "remove" or "headshot". */
191
222
  endpoint: string;
@@ -367,6 +398,39 @@ declare class Knockout {
367
398
  * await writeFile("colorized.png", buf);
368
399
  */
369
400
  colorize(input: ColorizeInput): Promise<Buffer>;
401
+ /**
402
+ * Inpaint a region of an image using LaMa (Apache-2.0). Three modes,
403
+ * auto-detected from what you pass:
404
+ *
405
+ * 1. **auto-subject** — pass only `file`. BiRefNet derives the subject
406
+ * mask, inverts it, and LaMa fills the subject region with plausible
407
+ * background. Drop in a photo, get the subject erased.
408
+ * 2. **mask** — pass `file` + `mask` (any image, white = inpaint).
409
+ * 3. **bbox** — pass `file` + `bbox: { x, y, w, h }`. Rectangular region.
410
+ *
411
+ * `dilation` (0..32, default 8) expands the mask before LaMa runs to
412
+ * reduce ghost outlines from tight masks.
413
+ *
414
+ * @example Auto-erase subject
415
+ * const png = await client.inpaint({ file: "./photo.jpg" });
416
+ *
417
+ * @example Erase a rectangular region
418
+ * const png = await client.inpaint({ file: "./photo.jpg", bbox: { x: 100, y: 100, w: 300, h: 400 } });
419
+ */
420
+ inpaint(input: InpaintInput): Promise<Buffer>;
421
+ /**
422
+ * Two-tone silhouette portrait — subject in one solid color, bg in another.
423
+ * Apple Music / Spotify avatar aesthetic. Reuses BiRefNet mask path; no new
424
+ * model load, fast.
425
+ *
426
+ * @example
427
+ * const png = await client.silhouette({
428
+ * file: "./portrait.jpg",
429
+ * subjectColor: "#1E2960",
430
+ * bgColor: "#F0857C",
431
+ * });
432
+ */
433
+ silhouette(input: SilhouetteInput): Promise<Buffer>;
370
434
  /**
371
435
  * Remove the background from up to 10 remote image URLs in a single call.
372
436
  *
@@ -379,4 +443,4 @@ declare class Knockout {
379
443
  private request;
380
444
  }
381
445
 
382
- export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, type ColorizeInput, type CompareInput, DEFAULT_BASE_URL, type EstimateInput, type EstimateResponse, type FaceRestoreInput, type HeadshotInput, type HealthResponse, Knockout, KnockoutError, type KnockoutOptions, type MaskInput, type OpaqueFormat, type OutlineInput, type OutputFormat, type PreviewInput, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, type ShadowInput, type SmartCropInput, type StatsDay, type StatsResponse, type StickerInput, type StudioShotInput, type UpscaleInput, Knockout as default };
446
+ export { type BatchInput, type BatchResponse, type BatchResultItem, type BatchUrlInput, type ColorizeInput, type CompareInput, DEFAULT_BASE_URL, type EstimateInput, type EstimateResponse, type FaceRestoreInput, type HeadshotInput, type HealthResponse, type InpaintBbox, type InpaintInput, Knockout, KnockoutError, type KnockoutOptions, type MaskInput, type OpaqueFormat, type OutlineInput, type OutputFormat, type PreviewInput, type RemoveInput, type RemoveUrlInput, type ReplaceBgInput, type ShadowInput, type SilhouetteInput, type SmartCropInput, type StatsDay, type StatsResponse, type StickerInput, type StudioShotInput, type UpscaleInput, Knockout as default };
package/dist/index.js CHANGED
@@ -3,7 +3,7 @@ import { basename } from 'path';
3
3
 
4
4
  // src/index.ts
5
5
  var DEFAULT_BASE_URL = "https://useknockout--api.modal.run";
6
- var SDK_VERSION = "0.1.0";
6
+ var SDK_VERSION = "0.2.0";
7
7
  var KnockoutError = class _KnockoutError extends Error {
8
8
  status;
9
9
  code;
@@ -379,6 +379,73 @@ var Knockout = class {
379
379
  if (!res.ok) throw new KnockoutError(res.status, await res.text());
380
380
  return Buffer.from(await res.arrayBuffer());
381
381
  }
382
+ /**
383
+ * Inpaint a region of an image using LaMa (Apache-2.0). Three modes,
384
+ * auto-detected from what you pass:
385
+ *
386
+ * 1. **auto-subject** — pass only `file`. BiRefNet derives the subject
387
+ * mask, inverts it, and LaMa fills the subject region with plausible
388
+ * background. Drop in a photo, get the subject erased.
389
+ * 2. **mask** — pass `file` + `mask` (any image, white = inpaint).
390
+ * 3. **bbox** — pass `file` + `bbox: { x, y, w, h }`. Rectangular region.
391
+ *
392
+ * `dilation` (0..32, default 8) expands the mask before LaMa runs to
393
+ * reduce ghost outlines from tight masks.
394
+ *
395
+ * @example Auto-erase subject
396
+ * const png = await client.inpaint({ file: "./photo.jpg" });
397
+ *
398
+ * @example Erase a rectangular region
399
+ * const png = await client.inpaint({ file: "./photo.jpg", bbox: { x: 100, y: 100, w: 300, h: 400 } });
400
+ */
401
+ async inpaint(input) {
402
+ const format = input.format ?? "png";
403
+ const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
404
+ const form = new FormData();
405
+ form.append("file", blob, filename);
406
+ if (input.mask !== void 0) {
407
+ const { blob: maskBlob, filename: maskFilename } = await toBlob({
408
+ file: input.mask,
409
+ filename: input.maskFilename ?? "mask.png"
410
+ });
411
+ form.append("mask", maskBlob, maskFilename);
412
+ }
413
+ if (input.bbox) {
414
+ form.append("x", String(input.bbox.x));
415
+ form.append("y", String(input.bbox.y));
416
+ form.append("w", String(input.bbox.w));
417
+ form.append("h", String(input.bbox.h));
418
+ }
419
+ if (input.dilation !== void 0) form.append("dilation", String(input.dilation));
420
+ form.append("format", format);
421
+ const res = await this.request("POST", "/inpaint", { body: form });
422
+ if (!res.ok) throw new KnockoutError(res.status, await res.text());
423
+ return Buffer.from(await res.arrayBuffer());
424
+ }
425
+ /**
426
+ * Two-tone silhouette portrait — subject in one solid color, bg in another.
427
+ * Apple Music / Spotify avatar aesthetic. Reuses BiRefNet mask path; no new
428
+ * model load, fast.
429
+ *
430
+ * @example
431
+ * const png = await client.silhouette({
432
+ * file: "./portrait.jpg",
433
+ * subjectColor: "#1E2960",
434
+ * bgColor: "#F0857C",
435
+ * });
436
+ */
437
+ async silhouette(input) {
438
+ const format = input.format ?? "png";
439
+ const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });
440
+ const form = new FormData();
441
+ form.append("file", blob, filename);
442
+ if (input.subjectColor) form.append("subject_color", input.subjectColor);
443
+ if (input.bgColor) form.append("bg_color", input.bgColor);
444
+ form.append("format", format);
445
+ const res = await this.request("POST", "/silhouette", { body: form });
446
+ if (!res.ok) throw new KnockoutError(res.status, await res.text());
447
+ return Buffer.from(await res.arrayBuffer());
448
+ }
382
449
  /**
383
450
  * Remove the background from up to 10 remote image URLs in a single call.
384
451
  *
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\r\n *\r\n * Quick start:\r\n *\r\n * import { Knockout } from \"@useknockout/node\";\r\n *\r\n * const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\r\n * const png = await client.remove({ file: \"./input.jpg\" }); // Buffer of PNG bytes\r\n * await writeFile(\"out.png\", png);\r\n */\r\n\r\nimport { readFile } from \"node:fs/promises\";\r\nimport { basename } from \"node:path\";\r\n\r\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\r\nconst SDK_VERSION = \"0.1.0\";\r\n\r\nexport type OutputFormat = \"png\" | \"webp\";\r\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\r\n\r\ntype FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n\r\nexport interface KnockoutOptions {\r\n /** API bearer token. Required unless your self-hosted instance has no auth. */\r\n token?: string;\r\n /** Override the API base URL. Defaults to the hosted endpoint. */\r\n baseUrl?: string;\r\n /** Per-request timeout in milliseconds. Default 60_000. */\r\n timeoutMs?: number;\r\n /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\r\n fetch?: typeof fetch;\r\n}\r\n\r\nexport interface RemoveInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface RemoveUrlInput {\r\n /** Remote URL of the image to process. */\r\n url: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface ReplaceBgInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\r\n bgColor?: string;\r\n /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\r\n bgUrl?: string;\r\n /** Output format. \"jpg\" is smallest. Default \"png\". */\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface BatchInput {\r\n /** Array of local paths / buffers / blobs. Up to 10. */\r\n files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\r\n /** Optional filenames aligned to `files`. */\r\n filenames?: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchUrlInput {\r\n /** Remote URLs to process. Up to 10. */\r\n urls: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchResultItem {\r\n filename?: string;\r\n url?: string;\r\n success: boolean;\r\n format?: OutputFormat;\r\n size_bytes?: number;\r\n data_base64?: string;\r\n error?: string;\r\n}\r\n\r\nexport interface BatchResponse {\r\n count: number;\r\n format: OutputFormat;\r\n results: BatchResultItem[];\r\n}\r\n\r\nexport interface MaskInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface SmartCropInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Padding around the subject bbox, in pixels. Default 24. */\r\n padding?: number;\r\n /** Return transparent cutout (true) or cropped region from original (false). Default true. */\r\n transparent?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ShadowInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n bgUrl?: string;\r\n shadowColor?: string;\r\n shadowOffsetX?: number;\r\n shadowOffsetY?: number;\r\n shadowBlur?: number;\r\n shadowOpacity?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface StickerInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#FFFFFF\". */\r\n strokeColor?: string;\r\n /** Outline width in pixels. Default 20. */\r\n strokeWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface OutlineInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#000000\". */\r\n outlineColor?: string;\r\n /** Outline width in pixels. Default 4. */\r\n outlineWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface StudioShotInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n /** e.g. \"1:1\", \"4:5\", \"16:9\". Default \"1:1\". */\r\n aspect?: string;\r\n padding?: number;\r\n shadow?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface CompareInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface HeadshotInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the background. Default \"#FFFFFF\". Ignored if `bgBlur` is true. */\r\n bgColor?: string;\r\n /** Use a blurred copy of the original image as the background. Default false. */\r\n bgBlur?: boolean;\r\n /** Gaussian blur radius for the background when `bgBlur` is true. Default 20. */\r\n blurRadius?: number;\r\n /** Output aspect \"W:H\". Default \"4:5\" (portrait). */\r\n aspect?: string;\r\n /** Padding around the subject bbox, in pixels. Default 64. */\r\n padding?: number;\r\n /** Vertical headroom as a ratio of canvas height (0–0.5). Default 0.18. */\r\n headTopRatio?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface PreviewInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Long-edge cap in pixels (64–1024). Default 512. */\r\n maxDim?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface UpscaleInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Upscale factor: 2 or 4. Default 4. */\r\n scale?: 2 | 4;\r\n /**\r\n * Backend. `swin2sr` (default, v0.6.0+) is sharper on real photos.\r\n * `realesrgan` is the legacy backend — better on anime/illustrations.\r\n */\r\n model?: \"swin2sr\" | \"realesrgan\";\r\n /** Route through GFPGAN to fix facial detail. Slower, use for portraits. Implies realesrgan. */\r\n faceEnhance?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface FaceRestoreInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Restore only the most prominent face (faster). Default false (all faces). */\r\n onlyCenterFace?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ColorizeInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface EstimateInput {\r\n /** Endpoint name without leading slash, e.g. \"remove\" or \"headshot\". */\r\n endpoint: string;\r\n width: number;\r\n height: number;\r\n}\r\n\r\nexport interface EstimateResponse {\r\n endpoint: string;\r\n image_pixels: number;\r\n est_latency_ms_warm: number;\r\n est_latency_ms_cold: number;\r\n est_cost_usd: number;\r\n free_during_beta: boolean;\r\n note: string;\r\n}\r\n\r\nexport interface StatsDay {\r\n date: string;\r\n count: number;\r\n}\r\n\r\nexport interface StatsResponse {\r\n total_processed: number;\r\n today: number;\r\n last_7_days: StatsDay[];\r\n error?: string;\r\n detail?: string;\r\n}\r\n\r\nexport interface HealthResponse {\r\n status: string;\r\n model: string;\r\n}\r\n\r\n/**\r\n * Error thrown when the API returns a non-2xx response.\r\n */\r\nexport class KnockoutError extends Error {\r\n public readonly status: number;\r\n public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\r\n public readonly body: string;\r\n\r\n constructor(status: number, body: string) {\r\n const code = KnockoutError.classify(status);\r\n super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\r\n this.name = \"KnockoutError\";\r\n this.status = status;\r\n this.code = code;\r\n this.body = body;\r\n }\r\n\r\n private static classify(status: number): KnockoutError[\"code\"] {\r\n if (status === 401 || status === 403) return \"auth\";\r\n if (status === 429) return \"rate_limit\";\r\n if (status === 413) return \"payload_too_large\";\r\n if (status >= 400 && status < 500) return \"bad_request\";\r\n if (status >= 500) return \"server\";\r\n return \"unknown\";\r\n }\r\n}\r\n\r\n/**\r\n * useknockout API client.\r\n *\r\n * All methods return a `Buffer` (Node) of the processed image bytes.\r\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\r\n */\r\nexport class Knockout {\r\n private readonly baseUrl: string;\r\n private readonly token: string | undefined;\r\n private readonly timeoutMs: number;\r\n private readonly fetchImpl: typeof fetch;\r\n\r\n constructor(options: KnockoutOptions = {}) {\r\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\r\n this.token = options.token;\r\n this.timeoutMs = options.timeoutMs ?? 60_000;\r\n const fetchRef = options.fetch ?? globalThis.fetch;\r\n if (!fetchRef) {\r\n throw new Error(\r\n \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\r\n );\r\n }\r\n this.fetchImpl = fetchRef.bind(globalThis);\r\n }\r\n\r\n /** Hit GET /health — no auth required. */\r\n async health(): Promise<HealthResponse> {\r\n const res = await this.request(\"GET\", \"/health\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as HealthResponse;\r\n }\r\n\r\n /**\r\n * Public usage counter — total images processed all-time, today, and a 7-day breakdown.\r\n * Use for landing-page social proof. Eventually consistent across containers.\r\n */\r\n async stats(): Promise<StatsResponse> {\r\n const res = await this.request(\"GET\", \"/stats\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as StatsResponse;\r\n }\r\n\r\n /**\r\n * Predict latency + cost for an endpoint and image size without doing any GPU work.\r\n *\r\n * @example\r\n * const est = await client.estimate({ endpoint: \"remove\", width: 1024, height: 1024 });\r\n */\r\n async estimate(input: EstimateInput): Promise<EstimateResponse> {\r\n const res = await this.request(\"POST\", \"/estimate\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({\r\n endpoint: input.endpoint,\r\n width: input.width,\r\n height: input.height,\r\n }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as EstimateResponse;\r\n }\r\n\r\n /**\r\n * Remove the background from an image, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.remove({ file: \"./input.jpg\" });\r\n */\r\n async remove(input: RemoveInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob(input);\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const res = await this.request(\"POST\", `/remove?format=${format}`, {\r\n body: form,\r\n });\r\n\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\r\n */\r\n async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const res = await this.request(\"POST\", \"/remove-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ url: input.url, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Replace the background with a solid color or a remote image.\r\n *\r\n * @example Solid color\r\n * const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\r\n *\r\n * @example Remote image as new background\r\n * const png = await client.replaceBackground({\r\n * file: \"./cat.jpg\",\r\n * bgUrl: \"https://example.com/beach.jpg\",\r\n * });\r\n */\r\n async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const params = new URLSearchParams({ format });\r\n if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\r\n if (input.bgColor) params.set(\"bg_color\", input.bgColor);\r\n\r\n const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 images in a single call.\r\n * Returns a JSON object with base64-encoded result bytes per image.\r\n *\r\n * @example\r\n * const batch = await client.removeBatch({\r\n * files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\r\n * format: \"png\",\r\n * });\r\n * for (const r of batch.results) {\r\n * if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\r\n * }\r\n */\r\n async removeBatch(input: BatchInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.files.length === 0) throw new Error(\"At least one file required\");\r\n if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\r\n\r\n const form = new FormData();\r\n for (let i = 0; i < input.files.length; i++) {\r\n const name = input.filenames?.[i];\r\n const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\r\n form.append(\"files\", blob, filename);\r\n }\r\n\r\n const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n /**\r\n * Return only the alpha mask as a grayscale PNG/WebP.\r\n * Useful when chaining into your own compositing pipeline.\r\n */\r\n async mask(input: MaskInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/mask\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Auto-crop to the subject's tight bounding box with configurable padding.\r\n * Returns either a transparent cutout or a cropped region from the original image.\r\n */\r\n async smartCrop(input: SmartCropInput): Promise<Buffer> {\r\n const transparent = input.transparent ?? true;\r\n const format: OpaqueFormat =\r\n (input.format as OpaqueFormat | undefined) ?? (transparent ? \"png\" : \"jpg\");\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"padding\", String(input.padding ?? 24));\r\n form.append(\"transparent\", transparent ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/smart-crop\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Composite subject onto a new background with a configurable drop shadow.\r\n */\r\n async shadow(input: ShadowInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgUrl) form.append(\"bg_url\", input.bgUrl);\r\n if (input.shadowColor) form.append(\"shadow_color\", input.shadowColor);\r\n if (input.shadowOffsetX !== undefined) form.append(\"shadow_offset_x\", String(input.shadowOffsetX));\r\n if (input.shadowOffsetY !== undefined) form.append(\"shadow_offset_y\", String(input.shadowOffsetY));\r\n if (input.shadowBlur !== undefined) form.append(\"shadow_blur\", String(input.shadowBlur));\r\n if (input.shadowOpacity !== undefined) form.append(\"shadow_opacity\", String(input.shadowOpacity));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/shadow\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Sticker style — subject with a thick outline on transparent background.\r\n * Perfect for WhatsApp / iMessage / Telegram stickers.\r\n */\r\n async sticker(input: StickerInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.strokeColor) form.append(\"stroke_color\", input.strokeColor);\r\n if (input.strokeWidth !== undefined) form.append(\"stroke_width\", String(input.strokeWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/sticker\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Subject on transparent background with a thin configurable outline.\r\n */\r\n async outline(input: OutlineInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.outlineColor) form.append(\"outline_color\", input.outlineColor);\r\n if (input.outlineWidth !== undefined) form.append(\"outline_width\", String(input.outlineWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/outline\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.\r\n */\r\n async studioShot(input: StudioShotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.shadow !== undefined) form.append(\"shadow\", input.shadow ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/studio-shot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.\r\n */\r\n async compare(input: CompareInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/compare\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * LinkedIn-ready headshot preset — bg removal + portrait crop + center face + bg color or blur.\r\n *\r\n * @example Solid bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgColor: \"#0A0A0A\" });\r\n *\r\n * @example Blurred original as bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgBlur: true, blurRadius: 24 });\r\n */\r\n async headshot(input: HeadshotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgBlur !== undefined) form.append(\"bg_blur\", input.bgBlur ? \"true\" : \"false\");\r\n if (input.blurRadius !== undefined) form.append(\"blur_radius\", String(input.blurRadius));\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.headTopRatio !== undefined) form.append(\"head_top_ratio\", String(input.headTopRatio));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/headshot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Fast low-res preview cutout (~80ms warm). Skips pymatting refinement and downscales\r\n * input to `maxDim` (default 512px on the long edge). Use for UX progress indicators.\r\n */\r\n async preview(input: PreviewInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"max_dim\", String(input.maxDim ?? 512));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/preview\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * 2x / 4x super-resolution. Defaults to Swin2SR (SwinV2 transformer) for sharper\r\n * detail on real photos. Pass `model: \"realesrgan\"` for the legacy backend\r\n * (better on anime / illustrations). `faceEnhance: true` routes portraits\r\n * through GFPGAN.\r\n *\r\n * @example Cutout → 4x upscale (print-ready)\r\n * const png = await client.remove({ file: \"./photo.jpg\" });\r\n * const big = await client.upscale({ file: png, scale: 4 });\r\n */\r\n async upscale(input: UpscaleInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"scale\", String(input.scale ?? 4));\r\n form.append(\"model\", input.model ?? \"swin2sr\");\r\n if (input.faceEnhance !== undefined) {\r\n form.append(\"face_enhance\", input.faceEnhance ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/upscale\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * GFPGAN v1.4 portrait restoration — fix blurry / damaged / low-res faces.\r\n * Background is upscaled 2x by Real-ESRGAN. Pairs with /headshot.\r\n */\r\n async faceRestore(input: FaceRestoreInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.onlyCenterFace !== undefined) {\r\n form.append(\"only_center_face\", input.onlyCenterFace ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/face-restore\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Colorize a black-and-white or grayscale photo (DDColor v0.7.0+).\r\n *\r\n * Apache-2.0 model, single feed-forward (no diffusion), ~500ms warm on L4.\r\n * Works on any input — color photos are converted to grayscale internally\r\n * before color is predicted, which makes round-trip recoloring easy too.\r\n *\r\n * @example\r\n * const buf = await client.colorize({ file: \"./old-photo.jpg\" });\r\n * await writeFile(\"colorized.png\", buf);\r\n */\r\n async colorize(input: ColorizeInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/colorize\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 remote image URLs in a single call.\r\n *\r\n * @example\r\n * const batch = await client.removeBatchUrl({\r\n * urls: [\"https://a.jpg\", \"https://b.jpg\"],\r\n * });\r\n */\r\n async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.urls.length === 0) throw new Error(\"At least one URL required\");\r\n if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\r\n\r\n const res = await this.request(\"POST\", \"/remove-batch-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ urls: input.urls, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n private async request(\r\n method: \"GET\" | \"POST\",\r\n path: string,\r\n init: { headers?: Record<string, string>; body?: BodyInit } = {}\r\n ): Promise<Response> {\r\n const url = `${this.baseUrl}${path}`;\r\n const headers: Record<string, string> = {\r\n \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\r\n ...(init.headers ?? {}),\r\n };\r\n if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\r\n\r\n const controller = new AbortController();\r\n const timer = setTimeout(() => controller.abort(), this.timeoutMs);\r\n try {\r\n return await this.fetchImpl(url, {\r\n method,\r\n headers,\r\n body: init.body,\r\n signal: controller.signal,\r\n });\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n }\r\n}\r\n\r\nasync function toBlob(\r\n input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\r\n): Promise<{ blob: Blob; filename: string }> {\r\n const { file } = input;\r\n const filename = input.filename ?? inferFilename(file);\r\n\r\n if (typeof file === \"string\") {\r\n const data = await readFile(file);\r\n return { blob: new Blob([new Uint8Array(data)]), filename };\r\n }\r\n if (file instanceof Blob) {\r\n return { blob: file, filename };\r\n }\r\n if (file instanceof ArrayBuffer) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (file instanceof Uint8Array) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (Buffer.isBuffer(file)) {\r\n return {\r\n blob: new Blob([new Uint8Array(file)]),\r\n filename,\r\n };\r\n }\r\n throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\r\n}\r\n\r\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\r\n if (typeof file === \"string\") return basename(file) || \"image\";\r\n return \"image\";\r\n}\r\n\r\nexport default Knockout;\r\n"]}
1
+ {"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @useknockout/node — official TypeScript / Node.js client for the useknockout API.\r\n *\r\n * Quick start:\r\n *\r\n * import { Knockout } from \"@useknockout/node\";\r\n *\r\n * const client = new Knockout({ token: process.env.KNOCKOUT_TOKEN! });\r\n * const png = await client.remove({ file: \"./input.jpg\" }); // Buffer of PNG bytes\r\n * await writeFile(\"out.png\", png);\r\n */\r\n\r\nimport { readFile } from \"node:fs/promises\";\r\nimport { basename } from \"node:path\";\r\n\r\nexport const DEFAULT_BASE_URL = \"https://useknockout--api.modal.run\";\r\nconst SDK_VERSION = \"0.2.0\";\r\n\r\nexport type OutputFormat = \"png\" | \"webp\";\r\nexport type OpaqueFormat = \"png\" | \"webp\" | \"jpg\";\r\n\r\ntype FileInput = string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n\r\nexport interface KnockoutOptions {\r\n /** API bearer token. Required unless your self-hosted instance has no auth. */\r\n token?: string;\r\n /** Override the API base URL. Defaults to the hosted endpoint. */\r\n baseUrl?: string;\r\n /** Per-request timeout in milliseconds. Default 60_000. */\r\n timeoutMs?: number;\r\n /** Custom fetch (useful for edge runtimes / polyfills). Defaults to global fetch. */\r\n fetch?: typeof fetch;\r\n}\r\n\r\nexport interface RemoveInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface RemoveUrlInput {\r\n /** Remote URL of the image to process. */\r\n url: string;\r\n /** Output format. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface ReplaceBgInput {\r\n /** Local file path, Buffer, Blob, or ArrayBuffer of the foreground image. */\r\n file: string | Buffer | Blob | ArrayBuffer | Uint8Array;\r\n /** Optional filename — inferred from path when `file` is a string. */\r\n filename?: string;\r\n /** Hex color for the new background. Default \"#FFFFFF\". Ignored if `bgUrl` is set. */\r\n bgColor?: string;\r\n /** Remote URL of an image to use as the new background. Takes precedence over `bgColor`. */\r\n bgUrl?: string;\r\n /** Output format. \"jpg\" is smallest. Default \"png\". */\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface BatchInput {\r\n /** Array of local paths / buffers / blobs. Up to 10. */\r\n files: Array<string | Buffer | Blob | ArrayBuffer | Uint8Array>;\r\n /** Optional filenames aligned to `files`. */\r\n filenames?: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchUrlInput {\r\n /** Remote URLs to process. Up to 10. */\r\n urls: string[];\r\n /** Output format for each image. Default \"png\". */\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface BatchResultItem {\r\n filename?: string;\r\n url?: string;\r\n success: boolean;\r\n format?: OutputFormat;\r\n size_bytes?: number;\r\n data_base64?: string;\r\n error?: string;\r\n}\r\n\r\nexport interface BatchResponse {\r\n count: number;\r\n format: OutputFormat;\r\n results: BatchResultItem[];\r\n}\r\n\r\nexport interface MaskInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface SmartCropInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Padding around the subject bbox, in pixels. Default 24. */\r\n padding?: number;\r\n /** Return transparent cutout (true) or cropped region from original (false). Default true. */\r\n transparent?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ShadowInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n bgUrl?: string;\r\n shadowColor?: string;\r\n shadowOffsetX?: number;\r\n shadowOffsetY?: number;\r\n shadowBlur?: number;\r\n shadowOpacity?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface StickerInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#FFFFFF\". */\r\n strokeColor?: string;\r\n /** Outline width in pixels. Default 20. */\r\n strokeWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface OutlineInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the outline. Default \"#000000\". */\r\n outlineColor?: string;\r\n /** Outline width in pixels. Default 4. */\r\n outlineWidth?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface StudioShotInput {\r\n file: FileInput;\r\n filename?: string;\r\n bgColor?: string;\r\n /** e.g. \"1:1\", \"4:5\", \"16:9\". Default \"1:1\". */\r\n aspect?: string;\r\n padding?: number;\r\n shadow?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface CompareInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface HeadshotInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the background. Default \"#FFFFFF\". Ignored if `bgBlur` is true. */\r\n bgColor?: string;\r\n /** Use a blurred copy of the original image as the background. Default false. */\r\n bgBlur?: boolean;\r\n /** Gaussian blur radius for the background when `bgBlur` is true. Default 20. */\r\n blurRadius?: number;\r\n /** Output aspect \"W:H\". Default \"4:5\" (portrait). */\r\n aspect?: string;\r\n /** Padding around the subject bbox, in pixels. Default 64. */\r\n padding?: number;\r\n /** Vertical headroom as a ratio of canvas height (0–0.5). Default 0.18. */\r\n headTopRatio?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface PreviewInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Long-edge cap in pixels (64–1024). Default 512. */\r\n maxDim?: number;\r\n format?: OutputFormat;\r\n}\r\n\r\nexport interface UpscaleInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Upscale factor: 2 or 4. Default 4. */\r\n scale?: 2 | 4;\r\n /**\r\n * Backend. `swin2sr` (default, v0.6.0+) is sharper on real photos.\r\n * `realesrgan` is the legacy backend — better on anime/illustrations.\r\n */\r\n model?: \"swin2sr\" | \"realesrgan\";\r\n /** Route through GFPGAN to fix facial detail. Slower, use for portraits. Implies realesrgan. */\r\n faceEnhance?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface FaceRestoreInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Restore only the most prominent face (faster). Default false (all faces). */\r\n onlyCenterFace?: boolean;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface ColorizeInput {\r\n file: FileInput;\r\n filename?: string;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface SilhouetteInput {\r\n file: FileInput;\r\n filename?: string;\r\n /** Hex color for the subject silhouette. Default \"#7C3AED\" (purple). */\r\n subjectColor?: string;\r\n /** Hex color for the background. Default \"#FFFFFF\" (white). */\r\n bgColor?: string;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface InpaintBbox {\r\n x: number;\r\n y: number;\r\n w: number;\r\n h: number;\r\n}\r\n\r\nexport interface InpaintInput {\r\n file: FileInput;\r\n filename?: string;\r\n /**\r\n * Optional mask. White pixels = inpaint, black = keep. If omitted (and no\r\n * `bbox`), auto-subject mode runs BiRefNet on the input and inverts the\r\n * subject mask.\r\n */\r\n mask?: FileInput;\r\n maskFilename?: string;\r\n /** Rectangular region to inpaint. Mutually exclusive with `mask`. */\r\n bbox?: InpaintBbox;\r\n /** Mask dilation in pixels. Default 8, range 0..32. */\r\n dilation?: number;\r\n format?: OpaqueFormat;\r\n}\r\n\r\nexport interface EstimateInput {\r\n /** Endpoint name without leading slash, e.g. \"remove\" or \"headshot\". */\r\n endpoint: string;\r\n width: number;\r\n height: number;\r\n}\r\n\r\nexport interface EstimateResponse {\r\n endpoint: string;\r\n image_pixels: number;\r\n est_latency_ms_warm: number;\r\n est_latency_ms_cold: number;\r\n est_cost_usd: number;\r\n free_during_beta: boolean;\r\n note: string;\r\n}\r\n\r\nexport interface StatsDay {\r\n date: string;\r\n count: number;\r\n}\r\n\r\nexport interface StatsResponse {\r\n total_processed: number;\r\n today: number;\r\n last_7_days: StatsDay[];\r\n error?: string;\r\n detail?: string;\r\n}\r\n\r\nexport interface HealthResponse {\r\n status: string;\r\n model: string;\r\n}\r\n\r\n/**\r\n * Error thrown when the API returns a non-2xx response.\r\n */\r\nexport class KnockoutError extends Error {\r\n public readonly status: number;\r\n public readonly code: \"auth\" | \"rate_limit\" | \"bad_request\" | \"payload_too_large\" | \"server\" | \"unknown\";\r\n public readonly body: string;\r\n\r\n constructor(status: number, body: string) {\r\n const code = KnockoutError.classify(status);\r\n super(`Knockout API error ${status} (${code}): ${body || \"no body\"}`);\r\n this.name = \"KnockoutError\";\r\n this.status = status;\r\n this.code = code;\r\n this.body = body;\r\n }\r\n\r\n private static classify(status: number): KnockoutError[\"code\"] {\r\n if (status === 401 || status === 403) return \"auth\";\r\n if (status === 429) return \"rate_limit\";\r\n if (status === 413) return \"payload_too_large\";\r\n if (status >= 400 && status < 500) return \"bad_request\";\r\n if (status >= 500) return \"server\";\r\n return \"unknown\";\r\n }\r\n}\r\n\r\n/**\r\n * useknockout API client.\r\n *\r\n * All methods return a `Buffer` (Node) of the processed image bytes.\r\n * Use `.toString(\"base64\")` or `writeFile(path, buf)` to persist.\r\n */\r\nexport class Knockout {\r\n private readonly baseUrl: string;\r\n private readonly token: string | undefined;\r\n private readonly timeoutMs: number;\r\n private readonly fetchImpl: typeof fetch;\r\n\r\n constructor(options: KnockoutOptions = {}) {\r\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\r\n this.token = options.token;\r\n this.timeoutMs = options.timeoutMs ?? 60_000;\r\n const fetchRef = options.fetch ?? globalThis.fetch;\r\n if (!fetchRef) {\r\n throw new Error(\r\n \"Global fetch is unavailable. Provide `options.fetch` or use Node 18+.\"\r\n );\r\n }\r\n this.fetchImpl = fetchRef.bind(globalThis);\r\n }\r\n\r\n /** Hit GET /health — no auth required. */\r\n async health(): Promise<HealthResponse> {\r\n const res = await this.request(\"GET\", \"/health\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as HealthResponse;\r\n }\r\n\r\n /**\r\n * Public usage counter — total images processed all-time, today, and a 7-day breakdown.\r\n * Use for landing-page social proof. Eventually consistent across containers.\r\n */\r\n async stats(): Promise<StatsResponse> {\r\n const res = await this.request(\"GET\", \"/stats\");\r\n const body = await res.text();\r\n if (!res.ok) throw new KnockoutError(res.status, body);\r\n return JSON.parse(body) as StatsResponse;\r\n }\r\n\r\n /**\r\n * Predict latency + cost for an endpoint and image size without doing any GPU work.\r\n *\r\n * @example\r\n * const est = await client.estimate({ endpoint: \"remove\", width: 1024, height: 1024 });\r\n */\r\n async estimate(input: EstimateInput): Promise<EstimateResponse> {\r\n const res = await this.request(\"POST\", \"/estimate\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({\r\n endpoint: input.endpoint,\r\n width: input.width,\r\n height: input.height,\r\n }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as EstimateResponse;\r\n }\r\n\r\n /**\r\n * Remove the background from an image, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.remove({ file: \"./input.jpg\" });\r\n */\r\n async remove(input: RemoveInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob(input);\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const res = await this.request(\"POST\", `/remove?format=${format}`, {\r\n body: form,\r\n });\r\n\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from a remote URL, returning the cleaned PNG/WebP bytes.\r\n *\r\n * @example\r\n * const png = await client.removeUrl({ url: \"https://example.com/cat.jpg\" });\r\n */\r\n async removeUrl(input: RemoveUrlInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const res = await this.request(\"POST\", \"/remove-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ url: input.url, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Replace the background with a solid color or a remote image.\r\n *\r\n * @example Solid color\r\n * const jpg = await client.replaceBackground({ file: \"./cat.jpg\", bgColor: \"#FF5733\", format: \"jpg\" });\r\n *\r\n * @example Remote image as new background\r\n * const png = await client.replaceBackground({\r\n * file: \"./cat.jpg\",\r\n * bgUrl: \"https://example.com/beach.jpg\",\r\n * });\r\n */\r\n async replaceBackground(input: ReplaceBgInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n\r\n const params = new URLSearchParams({ format });\r\n if (input.bgUrl) params.set(\"bg_url\", input.bgUrl);\r\n if (input.bgColor) params.set(\"bg_color\", input.bgColor);\r\n\r\n const res = await this.request(\"POST\", `/replace-bg?${params.toString()}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 images in a single call.\r\n * Returns a JSON object with base64-encoded result bytes per image.\r\n *\r\n * @example\r\n * const batch = await client.removeBatch({\r\n * files: [\"./a.jpg\", \"./b.jpg\", \"./c.jpg\"],\r\n * format: \"png\",\r\n * });\r\n * for (const r of batch.results) {\r\n * if (r.success) await writeFile(r.filename!, Buffer.from(r.data_base64!, \"base64\"));\r\n * }\r\n */\r\n async removeBatch(input: BatchInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.files.length === 0) throw new Error(\"At least one file required\");\r\n if (input.files.length > 10) throw new Error(\"Max 10 files per batch\");\r\n\r\n const form = new FormData();\r\n for (let i = 0; i < input.files.length; i++) {\r\n const name = input.filenames?.[i];\r\n const { blob, filename } = await toBlob({ file: input.files[i]!, filename: name });\r\n form.append(\"files\", blob, filename);\r\n }\r\n\r\n const res = await this.request(\"POST\", `/remove-batch?format=${format}`, {\r\n body: form,\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n /**\r\n * Return only the alpha mask as a grayscale PNG/WebP.\r\n * Useful when chaining into your own compositing pipeline.\r\n */\r\n async mask(input: MaskInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/mask\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Auto-crop to the subject's tight bounding box with configurable padding.\r\n * Returns either a transparent cutout or a cropped region from the original image.\r\n */\r\n async smartCrop(input: SmartCropInput): Promise<Buffer> {\r\n const transparent = input.transparent ?? true;\r\n const format: OpaqueFormat =\r\n (input.format as OpaqueFormat | undefined) ?? (transparent ? \"png\" : \"jpg\");\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"padding\", String(input.padding ?? 24));\r\n form.append(\"transparent\", transparent ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/smart-crop\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Composite subject onto a new background with a configurable drop shadow.\r\n */\r\n async shadow(input: ShadowInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgUrl) form.append(\"bg_url\", input.bgUrl);\r\n if (input.shadowColor) form.append(\"shadow_color\", input.shadowColor);\r\n if (input.shadowOffsetX !== undefined) form.append(\"shadow_offset_x\", String(input.shadowOffsetX));\r\n if (input.shadowOffsetY !== undefined) form.append(\"shadow_offset_y\", String(input.shadowOffsetY));\r\n if (input.shadowBlur !== undefined) form.append(\"shadow_blur\", String(input.shadowBlur));\r\n if (input.shadowOpacity !== undefined) form.append(\"shadow_opacity\", String(input.shadowOpacity));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/shadow\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Sticker style — subject with a thick outline on transparent background.\r\n * Perfect for WhatsApp / iMessage / Telegram stickers.\r\n */\r\n async sticker(input: StickerInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.strokeColor) form.append(\"stroke_color\", input.strokeColor);\r\n if (input.strokeWidth !== undefined) form.append(\"stroke_width\", String(input.strokeWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/sticker\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Subject on transparent background with a thin configurable outline.\r\n */\r\n async outline(input: OutlineInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.outlineColor) form.append(\"outline_color\", input.outlineColor);\r\n if (input.outlineWidth !== undefined) form.append(\"outline_width\", String(input.outlineWidth));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/outline\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * E-commerce preset — cutout + tight crop + centered + optional shadow on a standard aspect canvas.\r\n */\r\n async studioShot(input: StudioShotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.shadow !== undefined) form.append(\"shadow\", input.shadow ? \"true\" : \"false\");\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/studio-shot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Before/after side-by-side preview — original on left, transparent cutout (on a checkerboard) on right.\r\n */\r\n async compare(input: CompareInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/compare\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * LinkedIn-ready headshot preset — bg removal + portrait crop + center face + bg color or blur.\r\n *\r\n * @example Solid bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgColor: \"#0A0A0A\" });\r\n *\r\n * @example Blurred original as bg\r\n * const jpg = await client.headshot({ file: \"./photo.jpg\", bgBlur: true, blurRadius: 24 });\r\n */\r\n async headshot(input: HeadshotInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"jpg\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n if (input.bgBlur !== undefined) form.append(\"bg_blur\", input.bgBlur ? \"true\" : \"false\");\r\n if (input.blurRadius !== undefined) form.append(\"blur_radius\", String(input.blurRadius));\r\n if (input.aspect) form.append(\"aspect\", input.aspect);\r\n if (input.padding !== undefined) form.append(\"padding\", String(input.padding));\r\n if (input.headTopRatio !== undefined) form.append(\"head_top_ratio\", String(input.headTopRatio));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/headshot\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Fast low-res preview cutout (~80ms warm). Skips pymatting refinement and downscales\r\n * input to `maxDim` (default 512px on the long edge). Use for UX progress indicators.\r\n */\r\n async preview(input: PreviewInput): Promise<Buffer> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"max_dim\", String(input.maxDim ?? 512));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/preview\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * 2x / 4x super-resolution. Defaults to Swin2SR (SwinV2 transformer) for sharper\r\n * detail on real photos. Pass `model: \"realesrgan\"` for the legacy backend\r\n * (better on anime / illustrations). `faceEnhance: true` routes portraits\r\n * through GFPGAN.\r\n *\r\n * @example Cutout → 4x upscale (print-ready)\r\n * const png = await client.remove({ file: \"./photo.jpg\" });\r\n * const big = await client.upscale({ file: png, scale: 4 });\r\n */\r\n async upscale(input: UpscaleInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"scale\", String(input.scale ?? 4));\r\n form.append(\"model\", input.model ?? \"swin2sr\");\r\n if (input.faceEnhance !== undefined) {\r\n form.append(\"face_enhance\", input.faceEnhance ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/upscale\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * GFPGAN v1.4 portrait restoration — fix blurry / damaged / low-res faces.\r\n * Background is upscaled 2x by Real-ESRGAN. Pairs with /headshot.\r\n */\r\n async faceRestore(input: FaceRestoreInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.onlyCenterFace !== undefined) {\r\n form.append(\"only_center_face\", input.onlyCenterFace ? \"true\" : \"false\");\r\n }\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/face-restore\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Colorize a black-and-white or grayscale photo (DDColor v0.7.0+).\r\n *\r\n * Apache-2.0 model, single feed-forward (no diffusion), ~500ms warm on L4.\r\n * Works on any input — color photos are converted to grayscale internally\r\n * before color is predicted, which makes round-trip recoloring easy too.\r\n *\r\n * @example\r\n * const buf = await client.colorize({ file: \"./old-photo.jpg\" });\r\n * await writeFile(\"colorized.png\", buf);\r\n */\r\n async colorize(input: ColorizeInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/colorize\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Inpaint a region of an image using LaMa (Apache-2.0). Three modes,\r\n * auto-detected from what you pass:\r\n *\r\n * 1. **auto-subject** — pass only `file`. BiRefNet derives the subject\r\n * mask, inverts it, and LaMa fills the subject region with plausible\r\n * background. Drop in a photo, get the subject erased.\r\n * 2. **mask** — pass `file` + `mask` (any image, white = inpaint).\r\n * 3. **bbox** — pass `file` + `bbox: { x, y, w, h }`. Rectangular region.\r\n *\r\n * `dilation` (0..32, default 8) expands the mask before LaMa runs to\r\n * reduce ghost outlines from tight masks.\r\n *\r\n * @example Auto-erase subject\r\n * const png = await client.inpaint({ file: \"./photo.jpg\" });\r\n *\r\n * @example Erase a rectangular region\r\n * const png = await client.inpaint({ file: \"./photo.jpg\", bbox: { x: 100, y: 100, w: 300, h: 400 } });\r\n */\r\n async inpaint(input: InpaintInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.mask !== undefined) {\r\n const { blob: maskBlob, filename: maskFilename } = await toBlob({\r\n file: input.mask,\r\n filename: input.maskFilename ?? \"mask.png\",\r\n });\r\n form.append(\"mask\", maskBlob, maskFilename);\r\n }\r\n if (input.bbox) {\r\n form.append(\"x\", String(input.bbox.x));\r\n form.append(\"y\", String(input.bbox.y));\r\n form.append(\"w\", String(input.bbox.w));\r\n form.append(\"h\", String(input.bbox.h));\r\n }\r\n if (input.dilation !== undefined) form.append(\"dilation\", String(input.dilation));\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/inpaint\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Two-tone silhouette portrait — subject in one solid color, bg in another.\r\n * Apple Music / Spotify avatar aesthetic. Reuses BiRefNet mask path; no new\r\n * model load, fast.\r\n *\r\n * @example\r\n * const png = await client.silhouette({\r\n * file: \"./portrait.jpg\",\r\n * subjectColor: \"#1E2960\",\r\n * bgColor: \"#F0857C\",\r\n * });\r\n */\r\n async silhouette(input: SilhouetteInput): Promise<Buffer> {\r\n const format: OpaqueFormat = input.format ?? \"png\";\r\n const { blob, filename } = await toBlob({ file: input.file, filename: input.filename });\r\n const form = new FormData();\r\n form.append(\"file\", blob, filename);\r\n if (input.subjectColor) form.append(\"subject_color\", input.subjectColor);\r\n if (input.bgColor) form.append(\"bg_color\", input.bgColor);\r\n form.append(\"format\", format);\r\n const res = await this.request(\"POST\", \"/silhouette\", { body: form });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return Buffer.from(await res.arrayBuffer());\r\n }\r\n\r\n /**\r\n * Remove the background from up to 10 remote image URLs in a single call.\r\n *\r\n * @example\r\n * const batch = await client.removeBatchUrl({\r\n * urls: [\"https://a.jpg\", \"https://b.jpg\"],\r\n * });\r\n */\r\n async removeBatchUrl(input: BatchUrlInput): Promise<BatchResponse> {\r\n const format: OutputFormat = input.format ?? \"png\";\r\n if (input.urls.length === 0) throw new Error(\"At least one URL required\");\r\n if (input.urls.length > 10) throw new Error(\"Max 10 URLs per batch\");\r\n\r\n const res = await this.request(\"POST\", \"/remove-batch-url\", {\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify({ urls: input.urls, format }),\r\n });\r\n if (!res.ok) throw new KnockoutError(res.status, await res.text());\r\n return (await res.json()) as BatchResponse;\r\n }\r\n\r\n private async request(\r\n method: \"GET\" | \"POST\",\r\n path: string,\r\n init: { headers?: Record<string, string>; body?: BodyInit } = {}\r\n ): Promise<Response> {\r\n const url = `${this.baseUrl}${path}`;\r\n const headers: Record<string, string> = {\r\n \"User-Agent\": `useknockout-node/${SDK_VERSION}`,\r\n ...(init.headers ?? {}),\r\n };\r\n if (this.token) headers[\"Authorization\"] = `Bearer ${this.token}`;\r\n\r\n const controller = new AbortController();\r\n const timer = setTimeout(() => controller.abort(), this.timeoutMs);\r\n try {\r\n return await this.fetchImpl(url, {\r\n method,\r\n headers,\r\n body: init.body,\r\n signal: controller.signal,\r\n });\r\n } finally {\r\n clearTimeout(timer);\r\n }\r\n }\r\n}\r\n\r\nasync function toBlob(\r\n input: { file: string | Buffer | Blob | ArrayBuffer | Uint8Array; filename?: string }\r\n): Promise<{ blob: Blob; filename: string }> {\r\n const { file } = input;\r\n const filename = input.filename ?? inferFilename(file);\r\n\r\n if (typeof file === \"string\") {\r\n const data = await readFile(file);\r\n return { blob: new Blob([new Uint8Array(data)]), filename };\r\n }\r\n if (file instanceof Blob) {\r\n return { blob: file, filename };\r\n }\r\n if (file instanceof ArrayBuffer) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (file instanceof Uint8Array) {\r\n return { blob: new Blob([new Uint8Array(file)]), filename };\r\n }\r\n if (Buffer.isBuffer(file)) {\r\n return {\r\n blob: new Blob([new Uint8Array(file)]),\r\n filename,\r\n };\r\n }\r\n throw new TypeError(\"Unsupported `file` input. Provide a path, Buffer, Blob, ArrayBuffer, or Uint8Array.\");\r\n}\r\n\r\nfunction inferFilename(file: string | Buffer | Blob | ArrayBuffer | Uint8Array): string {\r\n if (typeof file === \"string\") return basename(file) || \"image\";\r\n return \"image\";\r\n}\r\n\r\nexport default Knockout;\r\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@useknockout/node",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Official Node.js client for useknockout — state-of-the-art background removal API.",
5
5
  "keywords": [
6
6
  "background-removal",