@meterapp/car-image-sdk 1.0.0

package/dist/client.js

@@ -0,0 +1,400 @@
+import { CarImageError } from "./errors.js";
+import { imageRequestBody, imageSearchParams, normalizeYear } from "./params.js";
+import { RETRYABLE_STATUSES, backoffDelayMs, parseRetryAfter } from "./retry.js";
+import { DEFAULT_BASE_URL, } from "./types.js";
+import { SDK_VERSION } from "./version.js";
+function readEnv(name) {
+    const proc = globalThis.process;
+    const value = proc?.env?.[name];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function intHeader(headers, name) {
+    const raw = headers.get(name);
+    if (raw === null || raw === "")
+        return null;
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : null;
+}
+function sourceHeader(headers) {
+    const raw = headers.get("x-image-source");
+    return raw === "cache" || raw === "generated" ? raw : null;
+}
+function defaultSleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Client for the Car Image API. Safe for Node 20+, edge runtimes and browsers
+ * (in browsers, prefer signed delivery URLs created server-side so the API key
+ * never ships to the client).
+ */
+export class CarImageClient {
+    baseUrl;
+    userAgent;
+    maxRetries;
+    retryBaseDelayMs;
+    maxRetryDelayMs;
+    timeoutMs;
+    apiKey;
+    fetchImpl;
+    sleep;
+    constructor(options = {}) {
+        this.baseUrl = (options.baseUrl ?? readEnv("CAR_IMAGE_API_URL") ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.apiKey = options.apiKey?.trim() || readEnv("CAR_IMAGE_API_KEY");
+        const fetchImpl = options.fetch ?? (typeof globalThis.fetch === "function" ? globalThis.fetch.bind(globalThis) : undefined);
+        if (!fetchImpl) {
+            throw new Error("No fetch implementation available. Pass { fetch } to CarImageClient.");
+        }
+        this.fetchImpl = fetchImpl;
+        this.userAgent = options.userAgent ?? `car-image-sdk/${SDK_VERSION}`;
+        this.maxRetries = Math.max(0, Math.floor(options.maxRetries ?? 2));
+        this.retryBaseDelayMs = options.retryBaseDelayMs ?? 500;
+        this.maxRetryDelayMs = options.maxRetryDelayMs ?? 30_000;
+        this.timeoutMs = options.timeoutMs;
+        this.sleep = options.sleep ?? defaultSleep;
+    }
+    /** Whether a key is configured; the key itself is never exposed. */
+    get hasApiKey() {
+        return Boolean(this.apiKey);
+    }
+    /** Display form such as `cimg_A1b2…9zY`; never logs the full key. */
+    maskedApiKey() {
+        if (!this.apiKey)
+            return null;
+        if (this.apiKey.length <= 12)
+            return `${this.apiKey.slice(0, 4)}…`;
+        return `${this.apiKey.slice(0, 9)}…${this.apiKey.slice(-3)}`;
+    }
+    /** Keeps the key out of `JSON.stringify(client)`, logs and error reports. */
+    toJSON() {
+        return {
+            baseUrl: this.baseUrl,
+            userAgent: this.userAgent,
+            maxRetries: this.maxRetries,
+            apiKey: this.maskedApiKey(),
+        };
+    }
+    // ---------------------------------------------------------------- images
+    /** GET /api/v1/images/car — 1 credit; returns the bytes plus billing headers. */
+    async getImage(params, options = {}) {
+        const response = await this.send(`/api/v1/images/car?${imageSearchParams(params)}`, {
+            ...options,
+            accept: "image/png, image/webp, image/jpeg, image/*;q=0.9, application/problem+json;q=0.8",
+        });
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        return {
+            bytes,
+            contentType: response.headers.get("content-type") ?? "application/octet-stream",
+            width: intHeader(response.headers, "x-image-width"),
+            height: intHeader(response.headers, "x-image-height"),
+            creditsCharged: intHeader(response.headers, "x-credits-charged"),
+            creditsRemaining: intHeader(response.headers, "x-credits-remaining"),
+            source: sourceHeader(response.headers),
+            etag: response.headers.get("etag"),
+            requestId: response.headers.get("x-request-id"),
+        };
+    }
+    /** GET /api/v1/images/car with `Accept: application/json` — 1 credit; returns a signed URL. */
+    async getImageUrl(params, options = {}) {
+        const response = await this.send(`/api/v1/images/car?${imageSearchParams(params)}`, {
+            ...options,
+            accept: "application/json",
+        });
+        return this.json(response);
+    }
+    /**
+     * POST /api/v1/image-urls — 1 credit per URL, charged at creation. Up to 50
+     * images per call. Redemptions are free within the TTL.
+     */
+    async createImageUrls(images, options = {}) {
+        const list = Array.isArray(images) ? images : [images];
+        if (list.length < 1 || list.length > 50) {
+            throw new RangeError(`createImageUrls accepts 1 to 50 images (received ${list.length})`);
+        }
+        const { ttlSeconds, maxUses, ...request } = options;
+        const body = { images: list.map(imageRequestBody) };
+        if (ttlSeconds !== undefined)
+            body.ttl_seconds = ttlSeconds;
+        if (maxUses !== undefined)
+            body.max_uses = maxUses;
+        const response = await this.send("/api/v1/image-urls", {
+            ...request,
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        return this.json(response);
+    }
+    /** GET /api/v1/images/options — public; views, colors, sizes, formats, pricing, catalog. */
+    async options(options = {}) {
+        const response = await this.send("/api/v1/images/options", { ...options, auth: "optional" });
+        return this.json(response);
+    }
+    /** POST /api/v1/images/resolve — free; turns "red 2024 porsche 911 side view" into parameters. */
+    async resolve(query, options = {}) {
+        if (typeof query !== "string" || !query.trim())
+            throw new TypeError("query is required");
+        const response = await this.send("/api/v1/images/resolve", {
+            ...options,
+            method: "POST",
+            body: JSON.stringify({ query: query.trim() }),
+        });
+        return this.json(response);
+    }
+    async vehicles(filter = {}, options = {}) {
+        const search = new URLSearchParams();
+        if (filter.year !== undefined)
+            search.set("year", String(normalizeYear(filter.year)));
+        if (filter.makeId !== undefined)
+            search.set("makeId", String(filter.makeId));
+        const query = search.size ? `?${search}` : "";
+        const response = await this.send(`/api/v1/vehicles${query}`, { ...options, auth: "optional" });
+        return this.json(response);
+    }
+    /** GET /api/v1/vehicles?q= — public fuzzy search across makes and models. */
+    async searchVehicles(query, options = {}) {
+        if (typeof query !== "string" || !query.trim())
+            throw new TypeError("query is required");
+        const { limit, year, ...request } = options;
+        const search = new URLSearchParams({ q: query.trim() });
+        if (limit !== undefined)
+            search.set("limit", String(limit));
+        if (year !== undefined)
+            search.set("year", String(normalizeYear(year)));
+        const response = await this.send(`/api/v1/vehicles?${search}`, { ...request, auth: "optional" });
+        return this.json(response);
+    }
+    // ------------------------------------------------------------- feedback
+    /** POST /api/v1/feedback — free; rate a delivered image by request id or by vehicle. */
+    async feedback(input, options = {}) {
+        if (input.rating === undefined && input.verdict === undefined) {
+            throw new TypeError("feedback requires a rating (1-5) or a verdict (good|bad)");
+        }
+        const body = {};
+        if ("requestId" in input && input.requestId) {
+            body.request_id = input.requestId;
+        }
+        else if ("make" in input) {
+            Object.assign(body, imageRequestBody(input));
+            delete body.width;
+            delete body.height;
+            delete body.format;
+        }
+        else {
+            throw new TypeError("feedback requires requestId or make/model/year");
+        }
+        if (input.rating !== undefined)
+            body.rating = input.rating;
+        if (input.verdict !== undefined)
+            body.verdict = input.verdict;
+        if (input.reason !== undefined)
+            body.reason = input.reason;
+        const response = await this.send("/api/v1/feedback", {
+            ...options,
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        return this.json(response);
+    }
+    // -------------------------------------------------------------- account
+    /** GET /api/v1/account — credits, auto-reload, 30-day usage, key scopes. */
+    async account(options = {}) {
+        const response = await this.send("/api/v1/account", options);
+        return this.json(response);
+    }
+    /** POST /api/v1/billing/checkout — hosted Stripe Checkout URL (scope billing:write). */
+    async createCheckout(credits, options = {}) {
+        if (!Number.isInteger(credits) || credits <= 0)
+            throw new RangeError("credits must be a positive integer");
+        const response = await this.send("/api/v1/billing/checkout", {
+            ...options,
+            method: "POST",
+            body: JSON.stringify({ credits }),
+        });
+        return this.json(response);
+    }
+    /** POST /api/v1/billing/portal — Stripe Customer Portal URL (scope billing:write). */
+    async billingPortal(options = {}) {
+        const response = await this.send("/api/v1/billing/portal", { ...options, method: "POST", body: "{}" });
+        return this.json(response);
+    }
+    // ----------------------------------------------------------------- meta
+    /** GET /api/health — public. */
+    async health(options = {}) {
+        const response = await this.send("/api/health", { ...options, auth: "none" });
+        return this.json(response);
+    }
+    /** GET /openapi.json — public machine-readable contract. */
+    async openapi(options = {}) {
+        const response = await this.send("/openapi.json", { ...options, auth: "none" });
+        return this.json(response);
+    }
+    /** POST /api/auth/device/code — start browser-assisted login (public). */
+    async startDeviceLogin(input = {}, options = {}) {
+        const response = await this.send("/api/auth/device/code", {
+            ...options,
+            method: "POST",
+            auth: "none",
+            body: JSON.stringify(input.clientName ? { client_name: input.clientName } : {}),
+        });
+        return this.json(response);
+    }
+    /** POST /api/auth/device/token — one poll; returns pending/expired/approved without throwing. */
+    async pollDeviceLogin(deviceCode, options = {}) {
+        const response = await this.rawSend("/api/auth/device/token", {
+            ...options,
+            method: "POST",
+            auth: "none",
+            retries: 0,
+            body: JSON.stringify({ device_code: deviceCode }),
+        });
+        if (response.ok) {
+            const token = (await response.json());
+            return {
+                status: "approved",
+                accessToken: token.access_token,
+                tokenType: token.token_type ?? "Bearer",
+                scope: token.scope ?? "",
+            };
+        }
+        if (response.status === 400 || response.status === 428) {
+            let code = "";
+            try {
+                const body = (await response.clone().json());
+                code = body.error ?? "";
+            }
+            catch {
+                code = "";
+            }
+            if (code === "authorization_pending" || code === "slow_down")
+                return { status: "pending" };
+            if (code === "expired_token")
+                return { status: "expired" };
+        }
+        throw await CarImageError.fromResponse(response);
+    }
+    /** POST /api/v1/events — anonymous telemetry; public, never retried. */
+    async trackEvents(events, options = {}) {
+        if (events.length === 0)
+            return;
+        await this.send("/api/v1/events", {
+            ...options,
+            method: "POST",
+            auth: "none",
+            retries: 0,
+            body: JSON.stringify({ events }),
+        });
+    }
+    /**
+     * Authenticated raw fetch for anything not covered above. No retries, no
+     * throwing on HTTP errors. The `Authorization` header is only attached when
+     * the target shares the client's origin, so a foreign URL never sees the key.
+     */
+    async fetch(pathOrUrl, init = {}) {
+        const url = this.url(pathOrUrl);
+        const headers = new Headers(init.headers);
+        if (!headers.has("user-agent"))
+            headers.set("User-Agent", this.userAgent);
+        if (this.apiKey && !headers.has("authorization") && this.sameOrigin(url)) {
+            headers.set("Authorization", `Bearer ${this.apiKey}`);
+        }
+        return this.fetchImpl(url, { ...init, headers });
+    }
+    // ------------------------------------------------------------ internals
+    url(path) {
+        if (/^https?:\/\//i.test(path))
+            return path;
+        return `${this.baseUrl}${path.startsWith("/") ? "" : "/"}${path}`;
+    }
+    sameOrigin(url) {
+        try {
+            return new URL(url).origin === new URL(this.baseUrl).origin;
+        }
+        catch {
+            return false;
+        }
+    }
+    async json(response) {
+        return (await response.json());
+    }
+    signalFor(options) {
+        const timeout = options.timeoutMs ?? this.timeoutMs;
+        const timeoutSignal = timeout !== undefined && typeof AbortSignal.timeout === "function" ? AbortSignal.timeout(timeout) : undefined;
+        if (options.signal && timeoutSignal) {
+            const any = AbortSignal.any;
+            return typeof any === "function" ? any([options.signal, timeoutSignal]) : options.signal;
+        }
+        return options.signal ?? timeoutSignal;
+    }
+    /** Sends and throws `CarImageError` on any non-2xx response. */
+    async send(path, options = {}) {
+        const response = await this.rawSend(path, options);
+        if (response.ok)
+            return response;
+        throw await CarImageError.fromResponse(response);
+    }
+    /** Sends with retries but returns the final response, whatever its status. */
+    async rawSend(path, options = {}) {
+        const method = options.method ?? "GET";
+        const auth = options.auth ?? "required";
+        const headers = new Headers(options.headers);
+        headers.set("Accept", options.accept ?? "application/json");
+        if (!headers.has("user-agent"))
+            headers.set("User-Agent", this.userAgent);
+        if (options.body !== undefined && !headers.has("content-type")) {
+            headers.set("Content-Type", "application/json");
+        }
+        if (this.apiKey) {
+            if (auth !== "none")
+                headers.set("Authorization", `Bearer ${this.apiKey}`);
+        }
+        else if (auth === "required") {
+            throw new CarImageError({
+                status: 401,
+                title: "API key required",
+                detail: "Create the client with { apiKey } or set CAR_IMAGE_API_KEY. Get a key at https://car-imgs.vercel.app/dashboard or run `npx @meterapp/car-image login`.",
+            });
+        }
+        const retries = Math.max(0, options.retries ?? this.maxRetries);
+        const url = this.url(path);
+        const idempotent = method === "GET" || method === "HEAD";
+        for (let attempt = 0;; attempt += 1) {
+            let response;
+            try {
+                response = await this.fetchImpl(url, {
+                    method,
+                    headers,
+                    body: options.body,
+                    signal: this.signalFor(options),
+                });
+            }
+            catch (error) {
+                if (options.signal?.aborted)
+                    throw error;
+                if (attempt < retries && idempotent) {
+                    await this.sleep(backoffDelayMs(attempt, this.retryBaseDelayMs, this.maxRetryDelayMs));
+                    continue;
+                }
+                throw new CarImageError({
+                    status: 0,
+                    title: "Network error",
+                    detail: error instanceof Error ? error.message : String(error),
+                    cause: error,
+                });
+            }
+            if (response.ok || !RETRYABLE_STATUSES.has(response.status) || attempt >= retries) {
+                return response;
+            }
+            const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
+            const delay = retryAfter !== null
+                ? Math.min(retryAfter * 1000, this.maxRetryDelayMs)
+                : backoffDelayMs(attempt, this.retryBaseDelayMs, this.maxRetryDelayMs);
+            try {
+                await response.body?.cancel();
+            }
+            catch {
+                // Body already consumed or not cancellable; nothing to release.
+            }
+            await this.sleep(delay);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,52 @@
+/** RFC 9457 problem details as sent by the API (`application/problem+json`). */
+export interface ProblemDetails {
+    type?: string;
+    title?: string;
+    status?: number;
+    detail?: string;
+    request_id?: string;
+    /** Present on 402 responses. */
+    balance?: number;
+    /** Present on 402 responses. */
+    required_credits?: number;
+    [key: string]: unknown;
+}
+export interface CarImageErrorInit {
+    status: number;
+    title: string;
+    detail: string;
+    requestId?: string | null;
+    problem?: ProblemDetails | null;
+    retryAfterSeconds?: number | null;
+    headers?: Headers | null;
+    cause?: unknown;
+}
+/**
+ * Every failure surfaced by the SDK. `status` is the HTTP status (0 for network
+ * failures), `detail` is the human-readable explanation from the server and
+ * `requestId` lets support trace the call.
+ */
+export declare class CarImageError extends Error {
+    readonly status: number;
+    readonly title: string;
+    readonly detail: string;
+    readonly requestId: string | null;
+    readonly problem: ProblemDetails | null;
+    readonly retryAfterSeconds: number | null;
+    readonly headers: Headers | null;
+    constructor(init: CarImageErrorInit);
+    /** Builds an error from a non-2xx response, reading problem+json when present. */
+    static fromResponse(response: Response): Promise<CarImageError>;
+    /** 402: buy credits before retrying. Never retried automatically. */
+    get isInsufficientCredits(): boolean;
+    /** 429: honor `retryAfterSeconds`. */
+    get isRateLimited(): boolean;
+    /** 401 or 403. */
+    get isAuthentication(): boolean;
+    get isNotFound(): boolean;
+    /** 0 (network), 429 or 503. */
+    get isRetryable(): boolean;
+    toJSON(): ProblemDetails;
+}
+export declare function isCarImageError(error: unknown): error is CarImageError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;gBAErB,IAAI,EAAE,iBAAiB;IAanC,kFAAkF;WACrE,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAyCrE,qEAAqE;IACrE,IAAI,qBAAqB,IAAI,OAAO,CAEnC;IAED,sCAAsC;IACtC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,kBAAkB;IAClB,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,+BAA+B;IAC/B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,MAAM,IAAI,cAAc;CASzB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/errors.js

@@ -0,0 +1,98 @@
+/**
+ * Every failure surfaced by the SDK. `status` is the HTTP status (0 for network
+ * failures), `detail` is the human-readable explanation from the server and
+ * `requestId` lets support trace the call.
+ */
+export class CarImageError extends Error {
+    status;
+    title;
+    detail;
+    requestId;
+    problem;
+    retryAfterSeconds;
+    headers;
+    constructor(init) {
+        const suffix = init.requestId ? ` (request ${init.requestId})` : "";
+        super(`${init.title}: ${init.detail}${suffix}`, init.cause === undefined ? undefined : { cause: init.cause });
+        this.name = "CarImageError";
+        this.status = init.status;
+        this.title = init.title;
+        this.detail = init.detail;
+        this.requestId = init.requestId ?? null;
+        this.problem = init.problem ?? null;
+        this.retryAfterSeconds = init.retryAfterSeconds ?? null;
+        this.headers = init.headers ?? null;
+    }
+    /** Builds an error from a non-2xx response, reading problem+json when present. */
+    static async fromResponse(response) {
+        let text = "";
+        try {
+            text = await response.text();
+        }
+        catch {
+            text = "";
+        }
+        let problem = null;
+        if (text) {
+            try {
+                const parsed = JSON.parse(text);
+                if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                    problem = parsed;
+                }
+            }
+            catch {
+                problem = null;
+            }
+        }
+        const title = (typeof problem?.title === "string" && problem.title) ||
+            (response.statusText ? response.statusText : `HTTP ${response.status}`);
+        const detail = (typeof problem?.detail === "string" && problem.detail) ||
+            (typeof problem?.error === "string" && problem.error) ||
+            (text && !problem ? text.slice(0, 300) : `The server responded with HTTP ${response.status}.`);
+        const retryAfter = response.headers.get("retry-after");
+        const retryAfterSeconds = retryAfter && /^\d+$/.test(retryAfter.trim()) ? Number(retryAfter) : null;
+        return new CarImageError({
+            status: response.status,
+            title,
+            detail,
+            requestId: (typeof problem?.request_id === "string" && problem.request_id) ||
+                response.headers.get("x-request-id") ||
+                null,
+            problem,
+            retryAfterSeconds,
+            headers: response.headers,
+        });
+    }
+    /** 402: buy credits before retrying. Never retried automatically. */
+    get isInsufficientCredits() {
+        return this.status === 402;
+    }
+    /** 429: honor `retryAfterSeconds`. */
+    get isRateLimited() {
+        return this.status === 429;
+    }
+    /** 401 or 403. */
+    get isAuthentication() {
+        return this.status === 401 || this.status === 403;
+    }
+    get isNotFound() {
+        return this.status === 404;
+    }
+    /** 0 (network), 429 or 503. */
+    get isRetryable() {
+        return this.status === 0 || this.status === 429 || this.status === 503;
+    }
+    toJSON() {
+        return {
+            ...(this.problem ?? {}),
+            status: this.status,
+            title: this.title,
+            detail: this.detail,
+            request_id: this.requestId ?? undefined,
+        };
+    }
+}
+export function isCarImageError(error) {
+    return error instanceof CarImageError || (error instanceof Error && error.name === "CarImageError");
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { CarImageClient, type CarImageClientOptions, type RequestOptions } from "./client.js";
+export { CarImageError, isCarImageError, type CarImageErrorInit, type ProblemDetails } from "./errors.js";
+export { assertImageParams, imageRequestBody, imageSearchParams, normalizeYear, suggestedFileName, } from "./params.js";
+export { RETRYABLE_STATUSES, backoffDelayMs, parseRetryAfter, retryDelayMs } from "./retry.js";
+export * from "./types.js";
+export { SDK_VERSION } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1G,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/F,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { CarImageClient } from "./client.js";
+export { CarImageError, isCarImageError } from "./errors.js";
+export { assertImageParams, imageRequestBody, imageSearchParams, normalizeYear, suggestedFileName, } from "./params.js";
+export { RETRYABLE_STATUSES, backoffDelayMs, parseRetryAfter, retryDelayMs } from "./retry.js";
+export * from "./types.js";
+export { SDK_VERSION } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmD,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,eAAe,EAA+C,MAAM,aAAa,CAAC;AAC1G,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/F,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}