import { createClient } from "okslop";

// Get your API key here -> https://okslop.com/developers
const client = createClient({ accessKey: "YOUR_ACCESS_KEY" });

// Search images — text-heavy design assets are excluded by default.
const { results } = await client.images.search({ query: "mountain sunset" });

// Filter by type ("3d" is shorthand for render_3d), include design assets,
// or require people-free / brand-safe imagery.
await client.images.search({ query: "laptop", imageType: "photo", noPeople: true });
await client.images.search({ query: "logo", isDesign: true });               // ONLY design
await client.images.search({ query: "hero banner", includeDesign: true });   // mix all

// Random photo
const [photo] = await client.images.random({ count: 1 });

// Download (signed URL, valid 10 min)
const { url } = await client.images.download(photo.id);

// Or download directly as buffer/stream
const buffer = await client.images.downloadBuffer(photo.id);
const stream = await client.images.downloadStream(photo.id);

// Browse categories
const categories = await client.categories.list();
const nature = await client.categories.photos("nature", { perPage: 20 });

// Collections — organize photos by topic (requires API key)
const { collections } = await client.collections.list();
const col = await client.collections.create({ name: "Hero Backgrounds" });
await client.collections.addItem(col.id, { photoId: photo.id });
const detail = await client.collections.get(col.id, { query: "sunset" });

// Saved photos
const saved = await client.saves.list({ page: 1 });

// Async pagination — iterate through all results
for await (const photo of client.images.iter({ sort: "popular" })) {
  console.log(photo.id);
}

// Same query + seed always returns the same photo
const photo = await client.images.seeded("sunset beach");                  // seed 1 (default)
const alt   = await client.images.seeded("sunset beach", { seed: 2 });     // next option
const wide  = await client.images.seeded("sunset beach", {                 // landscape only
  seed: 1,
  orientation: "landscape",
});

import { pickUrl, creditLine, descriptionOf } from "okslop";

// Pick the best URL variant for a target pixel width
pickUrl(photo, 300)     // → photo.urls.thumb   (≤400px)
pickUrl(photo, 700)     // → photo.urls.small   (≤800px)
pickUrl(photo, 1500)    // → photo.urls.full    (≤2000px)
pickUrl(photo)          // → photo.urls.regular  (default)

// Attribution string
creditLine(photo)       // → "Ada Lovelace on OKSLOP"

// Best available description (prefers alt_description)
descriptionOf(photo)    // → alt_description ?? description ?? ""

const items = await client.embed.submit([
  { prompt: "cozy coffee shop on a rainy afternoon", contributor: "nova-chen" },
  { prompt: "aerial view of autumn forest", contributor: "nova-chen", orientation: "landscape" },

  // Text-capable design pipeline (gpt-image-2) for posters, covers, logos
  { prompt: "summer tour poster, bold typography", contributor: "nova-chen", is_design: true },
]);

// items[0] → { id: "a7f3b2c1e9d4", status: "queued" }

const embed = await client.embed.get("a7f3b2c1e9d4");
// → { id, status: "completed", prompt, contributor, urls, createdAt }

const url = client.embed.imageUrl("a7f3b2c1e9d4", "preview");
// → "https://okslop.com/img/a7f3b2c1e9d4/preview"
// Use directly in <img src={url} />

const id = await client.embed.hashId({
  prompt: "cozy coffee shop on a rainy afternoon",
  contributor: "nova-chen",
});
// → "emb_a7f3b2c1e9d4"
// Deterministic — same inputs always return the same ID

// Poll until ready (or timeout)
const result = await client.embed.waitForResult("emb_a7f3b2c1e9d4", {
  timeout: 60000,      // max wait time in ms
  pollInterval: 2000,  // time between checks
});

for await (const photo of client.images.iter({ sort: "popular" })) {
  console.log(photo.id);
}

// Also available for search, categories, collections, saves
for await (const photo of client.images.searchIter({ query: "nature" })) { ... }
for await (const photo of client.categories.imagesIter("technology")) { ... }
for await (const photo of client.collections.iter("my-collection-id")) { ... }
for await (const photo of client.saves.iter()) { ... }

// Collect all results into an array
const allPhotos = await client.images.iter({ perPage: 50 }).toArray();

import { NotFoundError, RateLimitError, ValidationError, TimeoutError } from "okslop";

try {
  await client.images.get("nonexistent");
} catch (err) {
  if (err instanceof NotFoundError) {
    console.log("Photo not found");
  } else if (err instanceof RateLimitError) {
    console.log(`Retry after ${err.retryAfter} seconds`);
  } else if (err instanceof ValidationError) {
    console.log("Invalid request:", err.errors);
  } else if (err instanceof TimeoutError) {
    console.log(`Timed out after ${err.timeoutMs}ms`);
  }
}

const client = createClient({
  accessKey: "...",
  retry: {
    enabled: true,
    maxRetries: 3,
    baseDelay: 1000,
  },
});
// SDK automatically retries 429s with exponential backoff

const client = createClient({
  accessKey: "...",
  hooks: {
    beforeRequest: (req) => console.log("→", req.method, req.url),
    afterResponse: (res) => console.log("←", res.status),
    onError: (err, req) => console.error("✗", req.url, err.message),
  },
});

const controller = new AbortController();
setTimeout(() => controller.abort(), 5000);

const results = await client.images.search(
  { query: "nature" },
  { signal: controller.signal }
);

const client = createClient({
  accessKey: "...",
  fetch: myCustomFetch, // for testing, caching, or proxying
});