@quikturn/logos 0.2.0 → 0.2.1

package/dist/index.d.ts

@@ -1,19 +1,3 @@
-/**
- * @quikturn/logos SDK — Public Type Definitions
- *
- * All types mirror the Cloudflare Worker's type system exactly.
- * This file contains only type-level constructs (no runtime code).
- *
- * Source of truth: cf-worker-logos/src/types.ts, options.ts, rateLimit.ts, monthlyQuota.ts
- */
-/** Distinguishes between publishable (browser-safe) and secret (server-only) keys. */
-type KeyType = "publishable" | "secret";
-/** Valid key prefixes used to identify key type from the token string. */
-type KeyPrefix = "qt_" | "pk_" | "sk_";
-/** Subscription tier determining rate limits, monthly quotas, and max image width. */
-type Tier = "free" | "launch" | "growth" | "enterprise";
-/** Current lifecycle status of an API token. */
-type TokenStatus = "active" | "suspended" | "revoked";
 /** Theme adjusts the gamma curve applied during image transformation. */
 type ThemeOption = "light" | "dark";
 /** Full MIME-type output formats supported by the worker's image pipeline. */
@@ -29,7 +13,6 @@ type FormatShorthand = "png" | "jpeg" | "webp" | "avif";
  * - `greyscale`  — When true, applies saturation: 0 transformation. Default: false.
  * - `theme`      — "light" (gamma 0.9) or "dark" (gamma 1.12).
  * - `format`     — Output image format. Accepts full MIME type or shorthand. Default: "image/png".
- * - `autoScrape` — When true, triggers a background scrape if the logo is not found. Default: false.
  * - `baseUrl`    — Override the default API base URL. Useful for testing or proxied environments.
  */
 interface LogoRequestOptions {
@@ -39,7 +22,6 @@ interface LogoRequestOptions {
     greyscale?: boolean;
     theme?: ThemeOption;
     format?: SupportedOutputFormat | FormatShorthand;
-    autoScrape?: boolean;
     baseUrl?: string;
 }
 /**
@@ -96,34 +78,6 @@ interface ServerLogoResponse {
     contentType: string;
     metadata: LogoMetadata;
 }
-/**
- * Describes a background scrape job returned in a 202 response.
- *
- * - `jobId`           — Unique identifier for the scrape job.
- * - `pollUrl`         — URL to poll for scrape progress.
- * - `estimatedWaitMs` — Estimated time in milliseconds before the scrape completes.
- */
-interface ScrapeJob {
-    jobId: string;
-    pollUrl: string;
-    estimatedWaitMs: number;
-}
-/**
- * The JSON body returned by the worker when a 202 (scrape pending) response is issued.
- *
- * - `status`      — Always "scrape_pending".
- * - `message`     — Human-readable status message.
- * - `companyId`   — Optional identifier of the matched company.
- * - `companyName` — Optional name of the matched company.
- * - `scrapeJob`   — Details for polling the scrape job.
- */
-interface ScrapePendingResponse {
-    status: "scrape_pending";
-    message: string;
-    companyId?: number;
-    companyName?: string;
-    scrapeJob: ScrapeJob;
-}
 /** Lifecycle status of a background scrape job. */
 type ScrapeJobStatus = "pending" | "complete" | "failed";
 /**
@@ -145,32 +99,6 @@ interface ScrapeProgressEvent {
     };
     error?: string;
 }
-/**
- * Possible attribution verification states for free-tier consumers.
- *
- * - "verified"     — Attribution confirmed and valid.
- * - "pending"      — Verification in progress; treated as valid.
- * - "unverified"   — Attribution not yet set up.
- * - "failed"       — Verification attempted but failed.
- * - "grace-period" — Temporary grace; validity depends on graceDeadline.
- * - "error"        — An error occurred during verification.
- */
-type AttributionStatus = "verified" | "pending" | "unverified" | "failed" | "grace-period" | "error";
-/**
- * Structured attribution information parsed from response headers.
- *
- * - `status`        — Current attribution verification state.
- * - `graceDeadline` — If in grace period, the deadline by which attribution must be verified.
- * - `verifiedAt`    — Timestamp of when attribution was last verified.
- * - `isValid`       — Derived boolean: true when status is "verified", "pending",
- *                      or "grace-period" with a future graceDeadline.
- */
-interface AttributionInfo {
-    status: AttributionStatus;
-    graceDeadline?: Date;
-    verifiedAt?: Date;
-    isValid: boolean;
-}
 /**
  * Discriminated union of all machine-readable error codes used by the SDK.
  *
@@ -196,38 +124,12 @@ type LogoErrorCode = "DOMAIN_VALIDATION_ERROR" | "RATE_LIMIT_ERROR" | "QUOTA_EXC
 declare const BASE_URL: "https://logos.getquikturn.io";
 /** Default logo width in pixels when no size/width is provided. */
 declare const DEFAULT_WIDTH: 128;
-/** Maximum width (px) for requests using publishable keys (qt_/pk_). */
-declare const MAX_WIDTH: 800;
-/** Maximum width (px) for requests using secret keys (sk_). */
-declare const MAX_WIDTH_SERVER: 1200;
 /** Default MIME type returned when no format is specified. */
 declare const DEFAULT_FORMAT: SupportedOutputFormat;
 /** All MIME types the Logos API can produce. */
 declare const SUPPORTED_FORMATS: ReadonlySet<SupportedOutputFormat>;
 /** Maps shorthand format strings to their full MIME types. */
 declare const FORMAT_ALIASES: Readonly<Record<FormatShorthand, SupportedOutputFormat>>;
-/**
- * Per-tier rate limits for publishable-key (browser) requests.
- * All tiers share a 60-second sliding window.
- */
-declare const RATE_LIMITS: Readonly<Record<Tier, {
-    requests: number;
-    windowSeconds: number;
-}>>;
-/**
- * Per-tier rate limits for secret-key (server) requests.
- * The free tier does not have server-side access.
- */
-declare const SERVER_RATE_LIMITS: Readonly<Record<Exclude<Tier, "free">, {
-    requests: number;
-    windowSeconds: number;
-}>>;
-/** All subscription tiers as a runtime-iterable tuple. */
-declare const TIERS: readonly Tier[];
-/** All key types as a runtime-iterable tuple. */
-declare const KEY_TYPES: readonly KeyType[];
-/** Maximum logo requests per calendar month for each tier. */
-declare const MONTHLY_LIMITS: Readonly<Record<Tier, number>>;
 
 /**
  * @quikturn/logos SDK — URL Builder
@@ -264,74 +166,6 @@ declare const MONTHLY_LIMITS: Readonly<Record<Tier, number>>;
  */
 declare function logoUrl(domain: string, options?: LogoRequestOptions): string;
 
-/**
- * @quikturn/logos SDK — Response Header Parser
- *
- * Parses structured metadata from Cloudflare Worker response headers into
- * strongly-typed SDK objects. The worker attaches cache status, rate-limit
- * counters, monthly quota info, and image transformation details as custom
- * `X-` headers on every successful response.
- *
- * Two public functions are exported:
- * - `parseLogoHeaders` — extracts a full `LogoMetadata` object.
- * - `parseRetryAfter`  — extracts the `Retry-After` value for 429 handling.
- */
-
-/**
- * Parses Cloudflare Worker response headers into a `LogoMetadata` object.
- *
- * Extracts and normalizes the following header families:
- *
- * | Header                      | Field                           |
- * |-----------------------------|---------------------------------|
- * | `X-Cache-Status`            | `cache.status`                  |
- * | `X-RateLimit-Remaining`     | `rateLimit.remaining`           |
- * | `X-RateLimit-Reset`         | `rateLimit.reset` (as `Date`)   |
- * | `X-Quota-Remaining`         | `quota.remaining`               |
- * | `X-Quota-Limit`             | `quota.limit`                   |
- * | `X-Quikturn-Token`          | `tokenPrefix`                   |
- * | `X-Transformation-Applied`  | `transformation.applied`        |
- * | `X-Transformation-Status`   | `transformation.status`         |
- * | `X-Transformation-Method`   | `transformation.method`         |
- * | `X-Transformation-Width`    | `transformation.width`          |
- * | `X-Transformation-Greyscale`| `transformation.greyscale`      |
- * | `X-Transformation-Gamma`    | `transformation.gamma`          |
- *
- * Missing or unparseable numeric headers fall back to `0` for required fields
- * and `undefined` for optional fields. The cache status defaults to `"MISS"`
- * unless the header value is exactly `"HIT"`.
- *
- * @param headers - The `Headers` object from a fetch `Response`.
- * @returns A fully-populated `LogoMetadata` object.
- *
- * @example
- * ```ts
- * const response = await fetch(logoUrl("github.com"));
- * const metadata = parseLogoHeaders(response.headers);
- * console.log(metadata.cache.status); // "HIT" or "MISS"
- * ```
- */
-declare function parseLogoHeaders(headers: Headers): LogoMetadata;
-/**
- * Parses the `Retry-After` response header into a numeric value (seconds).
- *
- * The Logos API always sends `Retry-After` as an integer number of seconds
- * (not an HTTP-date). Returns `null` when the header is absent or its value
- * cannot be parsed as a finite number.
- *
- * @param headers - The `Headers` object from a fetch `Response`.
- * @returns The retry delay in seconds, or `null` if not present.
- *
- * @example
- * ```ts
- * const retryAfter = parseRetryAfter(response.headers);
- * if (retryAfter !== null) {
- *   await new Promise((r) => setTimeout(r, retryAfter * 1000));
- * }
- * ```
- */
-declare function parseRetryAfter(headers: Headers): number | null;
-
 /**
  * @quikturn/logos SDK — Error Classes
  *
@@ -434,4 +268,4 @@ declare class BadRequestError extends LogoError {
     constructor(message: string);
 }
 
-export { type AttributionInfo, type AttributionStatus, AuthenticationError, BASE_URL, BadRequestError, type BrowserLogoResponse, DEFAULT_FORMAT, DEFAULT_WIDTH, DomainValidationError, FORMAT_ALIASES, ForbiddenError, type FormatShorthand, KEY_TYPES, type KeyPrefix, type KeyType, LogoError, type LogoErrorCode, type LogoMetadata, type LogoRequestOptions, MAX_WIDTH, MAX_WIDTH_SERVER, MONTHLY_LIMITS, NotFoundError, QuotaExceededError, RATE_LIMITS, RateLimitError, SERVER_RATE_LIMITS, SUPPORTED_FORMATS, type ScrapeJob, type ScrapeJobStatus, type ScrapePendingResponse, type ScrapeProgressEvent, ScrapeTimeoutError, type ServerLogoResponse, type SupportedOutputFormat, TIERS, type ThemeOption, type Tier, type TokenStatus, logoUrl, parseLogoHeaders, parseRetryAfter };
+export { AuthenticationError, BASE_URL, BadRequestError, type BrowserLogoResponse, DEFAULT_FORMAT, DEFAULT_WIDTH, DomainValidationError, FORMAT_ALIASES, ForbiddenError, type FormatShorthand, LogoError, type LogoErrorCode, type LogoMetadata, type LogoRequestOptions, NotFoundError, QuotaExceededError, RateLimitError, SUPPORTED_FORMATS, type ScrapeProgressEvent, ScrapeTimeoutError, type ServerLogoResponse, type SupportedOutputFormat, type ThemeOption, logoUrl };

package/dist/index.mjs

@@ -16,25 +16,6 @@ var FORMAT_ALIASES = {
   webp: "image/webp",
   avif: "image/avif"
 };
-var RATE_LIMITS = {
-  free: { requests: 100, windowSeconds: 60 },
-  launch: { requests: 500, windowSeconds: 60 },
-  growth: { requests: 5e3, windowSeconds: 60 },
-  enterprise: { requests: 5e4, windowSeconds: 60 }
-};
-var SERVER_RATE_LIMITS = {
-  launch: { requests: 1e3, windowSeconds: 60 },
-  growth: { requests: 1e4, windowSeconds: 60 },
-  enterprise: { requests: 1e5, windowSeconds: 60 }
-};
-var TIERS = ["free", "launch", "growth", "enterprise"];
-var KEY_TYPES = ["publishable", "secret"];
-var MONTHLY_LIMITS = {
-  free: 5e5,
-  launch: 1e6,
-  growth: 5e6,
-  enterprise: 1e7
-};
 
 // src/errors.ts
 var LogoError = class extends Error {
@@ -199,7 +180,6 @@ function logoUrl(domain, options) {
     greyscale,
     theme,
     format,
-    autoScrape,
     baseUrl
   } = options ?? {};
   const maxWidth = token?.startsWith("sk_") ? MAX_WIDTH_SERVER : MAX_WIDTH;
@@ -226,69 +206,8 @@ function logoUrl(domain, options) {
   if (resolvedFormat !== void 0) {
     url.searchParams.set("format", resolvedFormat);
   }
-  if (autoScrape === true) {
-    url.searchParams.set("autoScrape", "true");
-  }
+  url.searchParams.set("autoScrape", "true");
   return url.toString();
 }
 
-// src/headers.ts
-function safeParseInt(value, fallback) {
-  if (value === null) return fallback;
-  const parsed = parseInt(value, 10);
-  return Number.isNaN(parsed) ? fallback : parsed;
-}
-function safeParseFloat(value, fallback) {
-  if (value === null) return fallback;
-  const parsed = parseFloat(value);
-  return Number.isNaN(parsed) ? fallback : parsed;
-}
-function parseLogoHeaders(headers) {
-  const cacheStatus = headers.get("X-Cache-Status");
-  const rateLimitRemaining = safeParseInt(headers.get("X-RateLimit-Remaining"), 0);
-  const rateLimitReset = safeParseInt(headers.get("X-RateLimit-Reset"), 0);
-  const quotaRemaining = safeParseInt(headers.get("X-Quota-Remaining"), 0);
-  const quotaLimit = safeParseInt(headers.get("X-Quota-Limit"), 0);
-  const tokenPrefix = headers.get("X-Quikturn-Token") ?? void 0;
-  const transformApplied = headers.get("X-Transformation-Applied") === "true";
-  const VALID_TRANSFORM_STATUSES = /* @__PURE__ */ new Set([
-    "not-requested",
-    "unsupported-format",
-    "transformation-error"
-  ]);
-  const rawTransformStatus = headers.get("X-Transformation-Status");
-  const transformStatus = rawTransformStatus && VALID_TRANSFORM_STATUSES.has(rawTransformStatus) ? rawTransformStatus : void 0;
-  const rawTransformMethod = headers.get("X-Transformation-Method");
-  const transformMethod = rawTransformMethod === "images-binding" ? "images-binding" : void 0;
-  const transformWidth = safeParseInt(headers.get("X-Transformation-Width"), void 0);
-  const transformGreyscale = headers.get("X-Transformation-Greyscale") === "true" ? true : void 0;
-  const transformGamma = safeParseFloat(headers.get("X-Transformation-Gamma"), void 0);
-  return {
-    cache: { status: cacheStatus === "HIT" ? "HIT" : "MISS" },
-    rateLimit: {
-      remaining: rateLimitRemaining,
-      reset: new Date(rateLimitReset * 1e3)
-    },
-    quota: {
-      remaining: quotaRemaining,
-      limit: quotaLimit
-    },
-    transformation: {
-      applied: transformApplied,
-      ...transformStatus ? { status: transformStatus } : {},
-      ...transformMethod ? { method: transformMethod } : {},
-      ...transformWidth !== void 0 ? { width: transformWidth } : {},
-      ...transformGreyscale !== void 0 ? { greyscale: transformGreyscale } : {},
-      ...transformGamma !== void 0 ? { gamma: transformGamma } : {}
-    },
-    ...tokenPrefix !== void 0 ? { tokenPrefix } : {}
-  };
-}
-function parseRetryAfter(headers) {
-  const value = headers.get("Retry-After");
-  if (value === null) return null;
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : null;
-}
-
-export { AuthenticationError, BASE_URL, BadRequestError, DEFAULT_FORMAT, DEFAULT_WIDTH, DomainValidationError, FORMAT_ALIASES, ForbiddenError, KEY_TYPES, LogoError, MAX_WIDTH, MAX_WIDTH_SERVER, MONTHLY_LIMITS, NotFoundError, QuotaExceededError, RATE_LIMITS, RateLimitError, SERVER_RATE_LIMITS, SUPPORTED_FORMATS, ScrapeTimeoutError, TIERS, logoUrl, parseLogoHeaders, parseRetryAfter };
+export { AuthenticationError, BASE_URL, BadRequestError, DEFAULT_FORMAT, DEFAULT_WIDTH, DomainValidationError, FORMAT_ALIASES, ForbiddenError, LogoError, NotFoundError, QuotaExceededError, RateLimitError, SUPPORTED_FORMATS, ScrapeTimeoutError, logoUrl };

package/dist/server/index.cjs

@@ -183,7 +183,6 @@ function logoUrl(domain, options) {
     greyscale,
     theme,
     format,
-    autoScrape,
     baseUrl
   } = options ?? {};
   const maxWidth = token?.startsWith("sk_") ? MAX_WIDTH_SERVER : MAX_WIDTH;
@@ -210,9 +209,7 @@ function logoUrl(domain, options) {
   if (resolvedFormat !== void 0) {
     url.searchParams.set("format", resolvedFormat);
   }
-  if (autoScrape === true) {
-    url.searchParams.set("autoScrape", "true");
-  }
+  url.searchParams.set("autoScrape", "true");
   return url.toString();
 }
 
@@ -672,7 +669,6 @@ var QuikturnLogos = class {
       greyscale: options?.greyscale,
       theme: options?.theme,
       format: options?.format,
-      autoScrape: options?.autoScrape,
       baseUrl: this.baseUrl
     });
     const format = options?.format;
@@ -685,23 +681,21 @@ var QuikturnLogos = class {
       onRateLimitWarning: (remaining, limit) => this.emit("rateLimitWarning", remaining, limit),
       onQuotaWarning: (remaining, limit) => this.emit("quotaWarning", remaining, limit)
     });
-    if (options?.autoScrape) {
-      const fetchForPoller = (fetchUrl) => serverFetch(fetchUrl, {
-        token: this.secretKey,
-        maxRetries: this.maxRetries,
+    const fetchForPoller = (fetchUrl) => serverFetch(fetchUrl, {
+      token: this.secretKey,
+      maxRetries: this.maxRetries,
+      signal: options?.signal
+    });
+    response = await handleScrapeResponse(
+      response,
+      url,
+      fetchForPoller,
+      {
+        scrapeTimeout: options?.scrapeTimeout,
+        onScrapeProgress: options?.onScrapeProgress,
         signal: options?.signal
-      });
-      response = await handleScrapeResponse(
-        response,
-        url,
-        fetchForPoller,
-        {
-          scrapeTimeout: options?.scrapeTimeout,
-          onScrapeProgress: options?.onScrapeProgress,
-          signal: options?.signal
-        }
-      );
-    }
+      }
+    );
     const contentLength = response.headers.get("Content-Length");
     if (contentLength) {
       const size = parseInt(contentLength, 10);
@@ -782,7 +776,6 @@ var QuikturnLogos = class {
       greyscale: options?.greyscale,
       theme: options?.theme,
       format: options?.format,
-      autoScrape: options?.autoScrape,
       baseUrl: this.baseUrl
     });
     const format = options?.format;
@@ -854,5 +847,3 @@ var QuikturnLogos = class {
 };
 
 exports.QuikturnLogos = QuikturnLogos;
-exports.getMany = getMany;
-exports.serverFetch = serverFetch;

package/dist/server/index.d.cts

@@ -157,96 +157,6 @@ interface BatchResult {
     metadata?: LogoMetadata;
     error?: LogoError;
 }
-/**
- * Fetches logos for multiple domains with concurrency control.
- * Yields results in the same order as the input domains array.
- *
- * The `fetchFn` parameter is a function that takes a domain and returns
- * a result object with buffer, contentType, metadata. This decouples
- * the batch module from the server fetcher implementation.
- *
- * Rate limit handling: when fetchFn throws a {@link RateLimitError},
- * the batch pauses ALL pending work for `retryAfter` seconds before
- * retrying the failed domain.
- *
- * @param domains  - Array of domain strings to fetch logos for.
- * @param fetchFn  - Async function that fetches a single logo by domain.
- * @param options  - Optional batch configuration.
- * @yields {BatchResult} Results in the same order as the input domains.
- */
-declare function getMany(domains: string[], fetchFn: (domain: string) => Promise<{
-    buffer: Buffer;
-    contentType: string;
-    metadata: LogoMetadata;
-}>, options?: BatchOptions): AsyncGenerator<BatchResult>;
-
-/**
- * @quikturn/logos SDK — Server Fetch Wrapper
- *
- * Low-level fetch wrapper for the server entry point. Handles HTTP error
- * mapping, retry logic for rate-limited and server-error responses,
- * AbortSignal propagation, and proactive warning callbacks when rate-limit
- * or quota headroom drops below 10%.
- *
- * Unlike the browser fetcher, this module sends the secret key as an
- * `Authorization: Bearer` header — tokens are NEVER appended as query
- * parameters.
- */
-/**
- * Options accepted by {@link serverFetch}.
- *
- * - `token`              — Required: secret key (`sk_` prefix) sent as Bearer token.
- * - `maxRetries`         — Maximum number of retry attempts for 429/500 responses. Default: 2.
- * - `signal`             — An `AbortSignal` to cancel the in-flight request.
- * - `format`             — MIME type string used as the `Accept` request header.
- * - `onRateLimitWarning` — Called when `X-RateLimit-Remaining` drops below 10% of the limit.
- * - `onQuotaWarning`     — Called when `X-Quota-Remaining` drops below 10% of the limit.
- */
-interface ServerFetcherOptions {
-    token: string;
-    maxRetries?: number;
-    signal?: AbortSignal;
-    format?: string;
-    onRateLimitWarning?: (remaining: number, limit: number) => void;
-    onQuotaWarning?: (remaining: number, limit: number) => void;
-}
-/**
- * Performs a fetch request to the Logos API with Bearer token authentication,
- * error mapping, and retry logic.
- *
- * **Key difference from browser fetcher:**
- * The secret key is sent as an `Authorization: Bearer {token}` header and is
- * NEVER included in the URL query string.
- *
- * **Error mapping:**
- * | Status | Error Class           | Notes                                      |
- * |--------|-----------------------|--------------------------------------------|
- * | 401    | AuthenticationError   | Invalid or missing API token               |
- * | 403    | ForbiddenError        | Body text used as `reason`                 |
- * | 404    | NotFoundError         | Domain extracted from URL path             |
- * | 429    | QuotaExceededError    | When `X-Quota-Limit` header is present     |
- * | 429    | RateLimitError        | After retries are exhausted                |
- * | 500    | LogoError             | After a single retry attempt               |
- *
- * **Retry behavior:**
- * - 429: Waits `Retry-After` seconds (default 60s), retries up to `maxRetries`.
- *        If `X-Quota-Limit` is present, throws `QuotaExceededError` immediately.
- * - 500: Retries once after a 1-second delay, then throws.
- * - AbortError: Never retried; throws immediately.
- * - Network errors: Never retried; throws immediately.
- *
- * @param url     - Fully-qualified Logos API URL (built by `logoUrl`).
- * @param options - Fetch configuration including the required `token`.
- * @returns The raw `Response` object on success (2xx).
- *
- * @throws {AuthenticationError} On 401.
- * @throws {ForbiddenError} On 403.
- * @throws {NotFoundError} On 404.
- * @throws {RateLimitError} On 429 after retries exhausted (no quota header).
- * @throws {QuotaExceededError} On 429 with `X-Quota-Limit` header.
- * @throws {LogoError} On 500, network error, or abort.
- */
-declare function serverFetch(url: string, options: ServerFetcherOptions): Promise<Response>;
 
 /**
  * @quikturn/logos SDK — Server Client Class
@@ -291,7 +201,6 @@ interface ServerClientOptions {
  * - `greyscale`       — When true, returns a greyscale image.
  * - `theme`           — "light" or "dark" gamma adjustment.
  * - `format`          — Output image format (MIME type or shorthand).
- * - `autoScrape`      — When true, triggers background scrape if logo is not found.
  * - `scrapeTimeout`   — Maximum time (ms) to wait for a scrape to complete.
  * - `onScrapeProgress`— Callback fired on each scrape poll.
  * - `signal`          — AbortSignal to cancel the request.
@@ -302,7 +211,6 @@ interface ServerGetOptions {
     greyscale?: boolean;
     theme?: ThemeOption;
     format?: SupportedOutputFormat | FormatShorthand;
-    autoScrape?: boolean;
     scrapeTimeout?: number;
     onScrapeProgress?: (event: ScrapeProgressEvent) => void;
     signal?: AbortSignal;
@@ -395,7 +303,7 @@ declare class QuikturnLogos {
      * @param options - Optional request parameters (size, format, etc.).
      * @returns A fully-qualified Logos API URL string (without token).
      */
-    getUrl(domain: string, options?: Omit<ServerGetOptions, "autoScrape" | "scrapeTimeout" | "onScrapeProgress" | "signal">): string;
+    getUrl(domain: string, options?: Omit<ServerGetOptions, "scrapeTimeout" | "onScrapeProgress" | "signal">): string;
     /**
      * Registers an event listener for a client event.
      *
@@ -420,4 +328,4 @@ declare class QuikturnLogos {
     private emit;
 }
 
-export { type BatchOptions, type BatchResult, type ClientEvent, type EventHandler, QuikturnLogos, type ServerClientOptions, type ServerFetcherOptions, type ServerGetOptions, getMany, serverFetch };
+export { type BatchOptions, type BatchResult, type ClientEvent, type EventHandler, QuikturnLogos, type ServerClientOptions, type ServerGetOptions };

package/dist/server/index.d.ts

@@ -157,96 +157,6 @@ interface BatchResult {
     metadata?: LogoMetadata;
     error?: LogoError;
 }
-/**
- * Fetches logos for multiple domains with concurrency control.
- * Yields results in the same order as the input domains array.
- *
- * The `fetchFn` parameter is a function that takes a domain and returns
- * a result object with buffer, contentType, metadata. This decouples
- * the batch module from the server fetcher implementation.
- *
- * Rate limit handling: when fetchFn throws a {@link RateLimitError},
- * the batch pauses ALL pending work for `retryAfter` seconds before
- * retrying the failed domain.
- *
- * @param domains  - Array of domain strings to fetch logos for.
- * @param fetchFn  - Async function that fetches a single logo by domain.
- * @param options  - Optional batch configuration.
- * @yields {BatchResult} Results in the same order as the input domains.
- */
-declare function getMany(domains: string[], fetchFn: (domain: string) => Promise<{
-    buffer: Buffer;
-    contentType: string;
-    metadata: LogoMetadata;
-}>, options?: BatchOptions): AsyncGenerator<BatchResult>;
-
-/**
- * @quikturn/logos SDK — Server Fetch Wrapper
- *
- * Low-level fetch wrapper for the server entry point. Handles HTTP error
- * mapping, retry logic for rate-limited and server-error responses,
- * AbortSignal propagation, and proactive warning callbacks when rate-limit
- * or quota headroom drops below 10%.
- *
- * Unlike the browser fetcher, this module sends the secret key as an
- * `Authorization: Bearer` header — tokens are NEVER appended as query
- * parameters.
- */
-/**
- * Options accepted by {@link serverFetch}.
- *
- * - `token`              — Required: secret key (`sk_` prefix) sent as Bearer token.
- * - `maxRetries`         — Maximum number of retry attempts for 429/500 responses. Default: 2.
- * - `signal`             — An `AbortSignal` to cancel the in-flight request.
- * - `format`             — MIME type string used as the `Accept` request header.
- * - `onRateLimitWarning` — Called when `X-RateLimit-Remaining` drops below 10% of the limit.
- * - `onQuotaWarning`     — Called when `X-Quota-Remaining` drops below 10% of the limit.
- */
-interface ServerFetcherOptions {
-    token: string;
-    maxRetries?: number;
-    signal?: AbortSignal;
-    format?: string;
-    onRateLimitWarning?: (remaining: number, limit: number) => void;
-    onQuotaWarning?: (remaining: number, limit: number) => void;
-}
-/**
- * Performs a fetch request to the Logos API with Bearer token authentication,
- * error mapping, and retry logic.
- *
- * **Key difference from browser fetcher:**
- * The secret key is sent as an `Authorization: Bearer {token}` header and is
- * NEVER included in the URL query string.
- *
- * **Error mapping:**
- * | Status | Error Class           | Notes                                      |
- * |--------|-----------------------|--------------------------------------------|
- * | 401    | AuthenticationError   | Invalid or missing API token               |
- * | 403    | ForbiddenError        | Body text used as `reason`                 |
- * | 404    | NotFoundError         | Domain extracted from URL path             |
- * | 429    | QuotaExceededError    | When `X-Quota-Limit` header is present     |
- * | 429    | RateLimitError        | After retries are exhausted                |
- * | 500    | LogoError             | After a single retry attempt               |
- *
- * **Retry behavior:**
- * - 429: Waits `Retry-After` seconds (default 60s), retries up to `maxRetries`.
- *        If `X-Quota-Limit` is present, throws `QuotaExceededError` immediately.
- * - 500: Retries once after a 1-second delay, then throws.
- * - AbortError: Never retried; throws immediately.
- * - Network errors: Never retried; throws immediately.
- *
- * @param url     - Fully-qualified Logos API URL (built by `logoUrl`).
- * @param options - Fetch configuration including the required `token`.
- * @returns The raw `Response` object on success (2xx).
- *
- * @throws {AuthenticationError} On 401.
- * @throws {ForbiddenError} On 403.
- * @throws {NotFoundError} On 404.
- * @throws {RateLimitError} On 429 after retries exhausted (no quota header).
- * @throws {QuotaExceededError} On 429 with `X-Quota-Limit` header.
- * @throws {LogoError} On 500, network error, or abort.
- */
-declare function serverFetch(url: string, options: ServerFetcherOptions): Promise<Response>;
 
 /**
  * @quikturn/logos SDK — Server Client Class
@@ -291,7 +201,6 @@ interface ServerClientOptions {
  * - `greyscale`       — When true, returns a greyscale image.
  * - `theme`           — "light" or "dark" gamma adjustment.
  * - `format`          — Output image format (MIME type or shorthand).
- * - `autoScrape`      — When true, triggers background scrape if logo is not found.
  * - `scrapeTimeout`   — Maximum time (ms) to wait for a scrape to complete.
  * - `onScrapeProgress`— Callback fired on each scrape poll.
  * - `signal`          — AbortSignal to cancel the request.
@@ -302,7 +211,6 @@ interface ServerGetOptions {
     greyscale?: boolean;
     theme?: ThemeOption;
     format?: SupportedOutputFormat | FormatShorthand;
-    autoScrape?: boolean;
     scrapeTimeout?: number;
     onScrapeProgress?: (event: ScrapeProgressEvent) => void;
     signal?: AbortSignal;
@@ -395,7 +303,7 @@ declare class QuikturnLogos {
      * @param options - Optional request parameters (size, format, etc.).
      * @returns A fully-qualified Logos API URL string (without token).
      */
-    getUrl(domain: string, options?: Omit<ServerGetOptions, "autoScrape" | "scrapeTimeout" | "onScrapeProgress" | "signal">): string;
+    getUrl(domain: string, options?: Omit<ServerGetOptions, "scrapeTimeout" | "onScrapeProgress" | "signal">): string;
     /**
      * Registers an event listener for a client event.
      *
@@ -420,4 +328,4 @@ declare class QuikturnLogos {
     private emit;
 }
 
-export { type BatchOptions, type BatchResult, type ClientEvent, type EventHandler, QuikturnLogos, type ServerClientOptions, type ServerFetcherOptions, type ServerGetOptions, getMany, serverFetch };
+export { type BatchOptions, type BatchResult, type ClientEvent, type EventHandler, QuikturnLogos, type ServerClientOptions, type ServerGetOptions };