@poof-bg/js 1.0.0

package/dist/index.js

@@ -0,0 +1,295 @@
+// src/errors.ts
+var PoofError = class _PoofError extends Error {
+  /** Machine-readable error code */
+  code;
+  /** HTTP status code */
+  status;
+  /** Unique request ID for support */
+  requestId;
+  /** Additional details */
+  details;
+  constructor(message, code, options) {
+    super(message);
+    this.name = "PoofError";
+    this.code = code;
+    this.status = options?.status;
+    this.requestId = options?.requestId;
+    this.details = options?.details;
+    if ("captureStackTrace" in Error && typeof Error.captureStackTrace === "function") {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+  /** Create error from API response */
+  static fromResponse(response, status) {
+    const ErrorClass = ERROR_MAP[response.code] || _PoofError;
+    return new ErrorClass(response.message, response.code, {
+      status,
+      requestId: response.request_id,
+      details: response.details
+    });
+  }
+};
+var AuthenticationError = class extends PoofError {
+  constructor(message, code, options) {
+    super(message, code, options);
+    this.name = "AuthenticationError";
+  }
+};
+var PermissionError = class extends PoofError {
+  constructor(message, code, options) {
+    super(message, code, options);
+    this.name = "PermissionError";
+  }
+};
+var PaymentRequiredError = class extends PoofError {
+  constructor(message, code, options) {
+    super(message, code, options);
+    this.name = "PaymentRequiredError";
+  }
+};
+var RateLimitError = class extends PoofError {
+  constructor(message, code, options) {
+    super(message, code, options);
+    this.name = "RateLimitError";
+  }
+};
+var ValidationError = class extends PoofError {
+  constructor(message, code, options) {
+    super(message, code, options);
+    this.name = "ValidationError";
+  }
+};
+var ServerError = class extends PoofError {
+  constructor(message, code, options) {
+    super(message, code, options);
+    this.name = "ServerError";
+  }
+};
+var ERROR_MAP = {
+  authentication_error: AuthenticationError,
+  permission_denied: PermissionError,
+  payment_required: PaymentRequiredError,
+  rate_limit_exceeded: RateLimitError,
+  validation_error: ValidationError,
+  missing_image: ValidationError,
+  image_too_large: ValidationError,
+  upstream_error: ServerError,
+  internal_server_error: ServerError
+};
+
+// src/utils.ts
+var isNode = typeof process !== "undefined" && process.versions?.node;
+function detectMimeType(buffer) {
+  if (buffer[0] === 137 && buffer[1] === 80 && buffer[2] === 78 && buffer[3] === 71) {
+    return "image/png";
+  }
+  if (buffer[0] === 255 && buffer[1] === 216 && buffer[2] === 255) {
+    return "image/jpeg";
+  }
+  if (buffer[0] === 82 && buffer[1] === 73 && buffer[2] === 70 && buffer[3] === 70) {
+    if (buffer[8] === 87 && buffer[9] === 69 && buffer[10] === 66 && buffer[11] === 80) {
+      return "image/webp";
+    }
+  }
+  if (buffer[0] === 71 && buffer[1] === 73 && buffer[2] === 70) {
+    return "image/gif";
+  }
+  return "application/octet-stream";
+}
+function getExtension(mimeType) {
+  const map = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/webp": "webp",
+    "image/gif": "gif"
+  };
+  return map[mimeType] || "bin";
+}
+async function toBlob(input) {
+  if (input instanceof Blob) {
+    return input;
+  }
+  if (input instanceof ArrayBuffer) {
+    const uint8 = new Uint8Array(input);
+    const mimeType = detectMimeType(uint8);
+    return new Blob([input], { type: mimeType });
+  }
+  if (input instanceof Uint8Array) {
+    const mimeType = detectMimeType(input);
+    return new Blob([input], { type: mimeType });
+  }
+  if (isNode && Buffer.isBuffer(input)) {
+    const uint8 = new Uint8Array(input);
+    const mimeType = detectMimeType(uint8);
+    return new Blob([input], { type: mimeType });
+  }
+  if (typeof input === "string") {
+    if (!isNode) {
+      throw new Error("File paths are only supported in Node.js. Use a Blob or File in the browser.");
+    }
+    const fs = await import('fs/promises');
+    const path = await import('path');
+    const buffer = await fs.readFile(input);
+    const uint8 = new Uint8Array(buffer);
+    const mimeType = detectMimeType(uint8);
+    const ext = path.extname(input).toLowerCase().slice(1);
+    const mimeFromExt = {
+      png: "image/png",
+      jpg: "image/jpeg",
+      jpeg: "image/jpeg",
+      webp: "image/webp",
+      gif: "image/gif"
+    };
+    const finalMimeType = mimeFromExt[ext] || mimeType;
+    return new Blob([buffer], { type: finalMimeType });
+  }
+  throw new Error(`Unsupported input type: ${typeof input}`);
+}
+function getFilename(input, mimeType) {
+  if (typeof File !== "undefined" && input instanceof File) {
+    return input.name;
+  }
+  if (typeof input === "string" && isNode) {
+    const parts = input.split(/[/\\]/);
+    return parts[parts.length - 1] || `image.${getExtension(mimeType)}`;
+  }
+  return `image.${getExtension(mimeType)}`;
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.poof.bg/v1";
+var DEFAULT_TIMEOUT = 6e4;
+var Poof = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl?.replace(/\/$/, "") || DEFAULT_BASE_URL;
+    this.timeout = options.timeout || DEFAULT_TIMEOUT;
+  }
+  /**
+   * Remove background from an image
+   *
+   * @param input - Image input: File, Blob, Buffer, ArrayBuffer, Uint8Array, or file path (Node.js)
+   * @param options - Processing options
+   * @returns Processed image data and metadata
+   *
+   * @example
+   * ```typescript
+   * // Basic usage
+   * const result = await poof.removeBackground(file);
+   * const imageBlob = new Blob([result.data], { type: result.metadata.contentType });
+   *
+   * // With options
+   * const result = await poof.removeBackground(file, {
+   *   format: 'webp',
+   *   crop: true,
+   *   size: 'medium'
+   * });
+   *
+   * // Node.js: from file path
+   * const result = await poof.removeBackground('/path/to/image.png');
+   *
+   * // Node.js: save to file
+   * const fs = require('fs');
+   * fs.writeFileSync('output.png', Buffer.from(result.data));
+   * ```
+   */
+  async removeBackground(input, options = {}) {
+    const blob = await toBlob(input);
+    const filename = getFilename(input, blob.type);
+    const formData = new FormData();
+    formData.append("image_file", blob, filename);
+    if (options.format) formData.append("format", options.format);
+    if (options.channels) formData.append("channels", options.channels);
+    if (options.bgColor) formData.append("bg_color", options.bgColor);
+    if (options.size) formData.append("size", options.size);
+    if (options.crop !== void 0) formData.append("crop", String(options.crop));
+    const response = await this.fetch(`${this.baseUrl}/remove`, {
+      method: "POST",
+      body: formData
+    });
+    if (!response.ok) {
+      await this.handleError(response);
+    }
+    const data = await response.arrayBuffer();
+    return {
+      data,
+      metadata: {
+        requestId: response.headers.get("X-Request-ID") || "",
+        processingTimeMs: parseInt(response.headers.get("X-Processing-Time-Ms") || "0", 10),
+        width: parseInt(response.headers.get("X-Image-Width") || "0", 10),
+        height: parseInt(response.headers.get("X-Image-Height") || "0", 10),
+        contentType: response.headers.get("Content-Type") || "image/png"
+      }
+    };
+  }
+  /**
+   * Get account information
+   *
+   * @returns Account info including plan and credit usage
+   *
+   * @example
+   * ```typescript
+   * const account = await poof.me();
+   * console.log(`Plan: ${account.plan}`);
+   * console.log(`Credits: ${account.usedCredits}/${account.maxCredits}`);
+   * ```
+   */
+  async me() {
+    const response = await this.fetch(`${this.baseUrl}/me`, {
+      method: "GET",
+      headers: {
+        Accept: "application/json"
+      }
+    });
+    if (!response.ok) {
+      await this.handleError(response);
+    }
+    return response.json();
+  }
+  /** Make a fetch request with auth and timeout */
+  async fetch(url, init) {
+    const headers = new Headers(init.headers);
+    headers.set("x-api-key", this.apiKey);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(url, {
+        ...init,
+        headers,
+        signal: controller.signal
+      });
+      return response;
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new PoofError("Request timeout", "timeout", { status: 408 });
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /** Handle error response */
+  async handleError(response) {
+    let errorData;
+    try {
+      errorData = await response.json();
+    } catch {
+      throw new PoofError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        "unknown_error",
+        { status: response.status }
+      );
+    }
+    throw PoofError.fromResponse(errorData, response.status);
+  }
+};
+
+export { AuthenticationError, PaymentRequiredError, PermissionError, Poof, PoofError, RateLimitError, ServerError, ValidationError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ErrorCode, ApiErrorResponse } from './types.js';\n\n/**\n * Base error class for all Poof SDK errors\n */\nexport class PoofError extends Error {\n  /** Machine-readable error code */\n  readonly code: string;\n  /** HTTP status code */\n  readonly status?: number;\n  /** Unique request ID for support */\n  readonly requestId?: string;\n  /** Additional details */\n  readonly details?: string;\n\n  constructor(\n    message: string,\n    code: string,\n    options?: { status?: number; requestId?: string; details?: string }\n  ) {\n    super(message);\n    this.name = 'PoofError';\n    this.code = code;\n    this.status = options?.status;\n    this.requestId = options?.requestId;\n    this.details = options?.details;\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    if ('captureStackTrace' in Error && typeof Error.captureStackTrace === 'function') {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  /** Create error from API response */\n  static fromResponse(response: ApiErrorResponse, status: number): PoofError {\n    const ErrorClass = ERROR_MAP[response.code] || PoofError;\n    return new ErrorClass(response.message, response.code, {\n      status,\n      requestId: response.request_id,\n      details: response.details,\n    });\n  }\n}\n\n/**\n * Thrown when the API key is invalid or missing\n */\nexport class AuthenticationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'AuthenticationError';\n  }\n}\n\n/**\n * Thrown when the account doesn't have permission\n */\nexport class PermissionError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PermissionError';\n  }\n}\n\n/**\n * Thrown when the account has insufficient credits\n */\nexport class PaymentRequiredError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PaymentRequiredError';\n  }\n}\n\n/**\n * Thrown when rate limit is exceeded\n */\nexport class RateLimitError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Thrown when request parameters are invalid\n */\nexport class ValidationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Thrown when a server error occurs\n */\nexport class ServerError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ServerError';\n  }\n}\n\n/** Map error codes to error classes */\nconst ERROR_MAP: Record<ErrorCode, typeof PoofError> = {\n  authentication_error: AuthenticationError,\n  permission_denied: PermissionError,\n  payment_required: PaymentRequiredError,\n  rate_limit_exceeded: RateLimitError,\n  validation_error: ValidationError,\n  missing_image: ValidationError,\n  image_too_large: ValidationError,\n  upstream_error: ServerError,\n  internal_server_error: ServerError,\n};\n","import type { ImageInput } from './types.js';\n\n/** Check if running in Node.js environment */\nexport const isNode = typeof process !== 'undefined' && process.versions?.node;\n\n/** Detect MIME type from buffer */\nfunction detectMimeType(buffer: Uint8Array): string {\n  // Check magic bytes\n  if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {\n    return 'image/png';\n  }\n  if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {\n    return 'image/jpeg';\n  }\n  if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46) {\n    // RIFF header, check for WEBP\n    if (buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50) {\n      return 'image/webp';\n    }\n  }\n  if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46) {\n    return 'image/gif';\n  }\n  // Default to octet-stream\n  return 'application/octet-stream';\n}\n\n/** Get file extension from MIME type */\nfunction getExtension(mimeType: string): string {\n  const map: Record<string, string> = {\n    'image/png': 'png',\n    'image/jpeg': 'jpg',\n    'image/webp': 'webp',\n    'image/gif': 'gif',\n  };\n  return map[mimeType] || 'bin';\n}\n\n/** Convert various input types to a Blob suitable for FormData */\nexport async function toBlob(input: ImageInput): Promise<Blob> {\n  // Already a Blob or File\n  if (input instanceof Blob) {\n    return input;\n  }\n\n  // ArrayBuffer\n  if (input instanceof ArrayBuffer) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Uint8Array\n  if (input instanceof Uint8Array) {\n    const mimeType = detectMimeType(input);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Node.js Buffer\n  if (isNode && Buffer.isBuffer(input)) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // String - treat as file path (Node.js only)\n  if (typeof input === 'string') {\n    if (!isNode) {\n      throw new Error('File paths are only supported in Node.js. Use a Blob or File in the browser.');\n    }\n    \n    const fs = await import('node:fs/promises');\n    const path = await import('node:path');\n    \n    const buffer = await fs.readFile(input);\n    const uint8 = new Uint8Array(buffer);\n    const mimeType = detectMimeType(uint8);\n    const ext = path.extname(input).toLowerCase().slice(1);\n    \n    // Use file extension for mime type if available\n    const mimeFromExt: Record<string, string> = {\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      webp: 'image/webp',\n      gif: 'image/gif',\n    };\n    \n    const finalMimeType = mimeFromExt[ext] || mimeType;\n    return new Blob([buffer], { type: finalMimeType });\n  }\n\n  throw new Error(`Unsupported input type: ${typeof input}`);\n}\n\n/** Get filename for FormData */\nexport function getFilename(input: ImageInput, mimeType: string): string {\n  // File has a name\n  if (typeof File !== 'undefined' && input instanceof File) {\n    return input.name;\n  }\n\n  // String path\n  if (typeof input === 'string' && isNode) {\n    // Extract filename from path\n    const parts = input.split(/[/\\\\]/);\n    return parts[parts.length - 1] || `image.${getExtension(mimeType)}`;\n  }\n\n  // Generate name from mime type\n  return `image.${getExtension(mimeType)}`;\n}\n","import type {\n  PoofOptions,\n  ImageInput,\n  RemoveBackgroundOptions,\n  RemoveBackgroundResult,\n  AccountInfo,\n  ApiErrorResponse,\n} from './types.js';\nimport { PoofError } from './errors.js';\nimport { toBlob, getFilename } from './utils.js';\n\nconst DEFAULT_BASE_URL = 'https://api.poof.bg/v1';\nconst DEFAULT_TIMEOUT = 60000;\n\n/**\n * Poof API client for background removal\n *\n * @example\n * ```typescript\n * import { Poof } from '@poof-bg/js';\n *\n * const poof = new Poof({ apiKey: 'your-api-key' });\n * const result = await poof.removeBackground(imageFile);\n * ```\n */\nexport class Poof {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: PoofOptions) {\n    if (!options.apiKey) {\n      throw new Error('API key is required');\n    }\n\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl?.replace(/\\/$/, '') || DEFAULT_BASE_URL;\n    this.timeout = options.timeout || DEFAULT_TIMEOUT;\n  }\n\n  /**\n   * Remove background from an image\n   *\n   * @param input - Image input: File, Blob, Buffer, ArrayBuffer, Uint8Array, or file path (Node.js)\n   * @param options - Processing options\n   * @returns Processed image data and metadata\n   *\n   * @example\n   * ```typescript\n   * // Basic usage\n   * const result = await poof.removeBackground(file);\n   * const imageBlob = new Blob([result.data], { type: result.metadata.contentType });\n   *\n   * // With options\n   * const result = await poof.removeBackground(file, {\n   *   format: 'webp',\n   *   crop: true,\n   *   size: 'medium'\n   * });\n   *\n   * // Node.js: from file path\n   * const result = await poof.removeBackground('/path/to/image.png');\n   *\n   * // Node.js: save to file\n   * const fs = require('fs');\n   * fs.writeFileSync('output.png', Buffer.from(result.data));\n   * ```\n   */\n  async removeBackground(\n    input: ImageInput,\n    options: RemoveBackgroundOptions = {}\n  ): Promise<RemoveBackgroundResult> {\n    const blob = await toBlob(input);\n    const filename = getFilename(input, blob.type);\n\n    const formData = new FormData();\n    formData.append('image_file', blob, filename);\n\n    // Add optional parameters\n    if (options.format) formData.append('format', options.format);\n    if (options.channels) formData.append('channels', options.channels);\n    if (options.bgColor) formData.append('bg_color', options.bgColor);\n    if (options.size) formData.append('size', options.size);\n    if (options.crop !== undefined) formData.append('crop', String(options.crop));\n\n    const response = await this.fetch(`${this.baseUrl}/remove`, {\n      method: 'POST',\n      body: formData,\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    const data = await response.arrayBuffer();\n\n    return {\n      data,\n      metadata: {\n        requestId: response.headers.get('X-Request-ID') || '',\n        processingTimeMs: parseInt(response.headers.get('X-Processing-Time-Ms') || '0', 10),\n        width: parseInt(response.headers.get('X-Image-Width') || '0', 10),\n        height: parseInt(response.headers.get('X-Image-Height') || '0', 10),\n        contentType: response.headers.get('Content-Type') || 'image/png',\n      },\n    };\n  }\n\n  /**\n   * Get account information\n   *\n   * @returns Account info including plan and credit usage\n   *\n   * @example\n   * ```typescript\n   * const account = await poof.me();\n   * console.log(`Plan: ${account.plan}`);\n   * console.log(`Credits: ${account.usedCredits}/${account.maxCredits}`);\n   * ```\n   */\n  async me(): Promise<AccountInfo> {\n    const response = await this.fetch(`${this.baseUrl}/me`, {\n      method: 'GET',\n      headers: {\n        Accept: 'application/json',\n      },\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json();\n  }\n\n  /** Make a fetch request with auth and timeout */\n  private async fetch(url: string, init: RequestInit): Promise<Response> {\n    const headers = new Headers(init.headers);\n    headers.set('x-api-key', this.apiKey);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers,\n        signal: controller.signal,\n      });\n      return response;\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new PoofError('Request timeout', 'timeout', { status: 408 });\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /** Handle error response */\n  private async handleError(response: Response): Promise<never> {\n    let errorData: ApiErrorResponse;\n\n    try {\n      errorData = await response.json();\n    } catch {\n      throw new PoofError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        'unknown_error',\n        { status: response.status }\n      );\n    }\n\n    throw PoofError.fromResponse(errorData, response.status);\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@poof-bg/js",
+  "version": "1.0.0",
+  "description": "Official Poof SDK for background removal",
+  "author": "Poof <support@poof.bg>",
+  "license": "MIT",
+  "homepage": "https://poof.bg",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/poof-bg/js"
+  },
+  "bugs": {
+    "url": "https://github.com/poof-bg/js/issues"
+  },
+  "keywords": [
+    "poof",
+    "background-removal",
+    "image-processing",
+    "ai",
+    "sdk"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}