SoManyLemons TypeScript SDK

Typed TypeScript client for the SoManyLemons Public API. Submit recordings, render branded reels and image quotes, manage brands and drafts — from any Node.js, Deno, or Bun app.

Zero runtime dependencies — uses native fetch (Node 18+).

Install

npm install somanylemons-sdk

Quickstart

import { SMLClient } from "somanylemons-sdk";

const client = new SMLClient({ apiKey: "sml_your_key_here" });

// List recordings
const jobs = await client.jobs.list({ limit: 5 });
for (const job of jobs) {
  console.log(job.id, job.title, job.clip_count, "clips");
}

// Submit a video and wait for rendered clips
const job = await client.reels.createAndWait({
  url: "https://example.com/recording.mp4",
  brand_profile_id: 1,
  caption_style: "LEMON",
});
for (const clip of job.clips ?? []) {
  console.log(clip.url);
}

// Render an image quote with a pinned template
const image = await client.imageQuotes.create({
  quote_text: "Labor productivity is the story of the next five years.",
  brand_profile_id: 1,
  template_id: 42,
});
console.log(image.image_url);

Configuration

Option	Env var	Default	Notes
`apiKey`	`SML_API_KEY`	— (required)	Your `sml_xxx` key
`baseUrl`	`SML_API_URL`	`https://api.somanylemons.com`	Override for QAS / local
`timeout`	—	`30000`	Milliseconds per request
`maxRetries`	—	`3`	Retries on 5xx and 429
`allowInsecureHttp`	—	`false`	Allow `http://` (for localhost)
`allowForeignHost`	—	`false`	Allow non-somanylemons.com hosts

Resources

Attribute	Endpoints
`client.jobs`	List, get, poll recordings
`client.reels`	Create reels (async or blocking via `createAndWait`)
`client.transcribe`	Transcribe URL (async or blocking)
`client.imageQuotes`	Render branded quote images
`client.brands`	Manage brand profiles
`client.drafts`	Content queue
`client.templates`	List available templates
`client.content`	Generate / score / rewrite posts, extract quotes, usage

Error handling

import { SMLClient, QuotaError, RateLimitError, JobFailedError } from "somanylemons-sdk";

const client = new SMLClient({ apiKey: "sml_xxx" });

try {
  const job = await client.reels.createAndWait({ url: "..." });
} catch (err) {
  if (err instanceof QuotaError) {
    console.log(`Over quota: ${err.rendersUsed}/${err.renderLimit}`);
  } else if (err instanceof RateLimitError) {
    console.log(`Rate limited, retry after ${err.retryAfter}s`);
  } else if (err instanceof JobFailedError) {
    console.log(`Render failed: ${err.message}`);
  }
}

Security

Keys never appear in toString() or logs. The transport masks the key.
HTTPS enforced by default. http:// URLs are rejected unless allowInsecureHttp: true.
Foreign hosts rejected by default. Only *.somanylemons.com and localhost are accepted.
Sensible retries. 5xx and 429 retry with backoff; 4xx fails fast.

License

MIT