@contenthero/sdk 0.1.0

package/README.md

@@ -0,0 +1,116 @@
+# @contenthero/sdk
+
+Official SDK for the [ContentHero](https://contenthero.ai) Studio API. Generate images, video, and audio programmatically. This is the shared kernel the ContentHero MCP and CLI sit on.
+
+## Install
+
+```bash
+npm install @contenthero/sdk
+```
+
+Requires Node 20+ (uses the global `fetch`).
+
+## Quick start
+
+```ts
+import { ContentHero } from '@contenthero/sdk'
+
+const client = new ContentHero({ apiKey: process.env.CONTENTHERO_API_KEY })
+
+// Submit and poll to completion.
+const image = await client.generateAndWait({
+  modelId: 'nano-banana-2',
+  prompt: 'a golden retriever astronaut on the moon, cinematic',
+  aspectRatio: '16:9',
+})
+
+console.log(image.outputUrls)
+```
+
+The API key (`ch_live_...`) is read from `CONTENTHERO_API_KEY` when not passed explicitly. Identity is resolved from the key server-side, so you never send a user id.
+
+## Generation is async
+
+On the wire, generation is always asynchronous: a submit returns immediately and you poll for the result. The SDK gives you both shapes.
+
+```ts
+// Fire-and-forget: returns as soon as the job is accepted.
+const { outputId } = await client.generate({
+  modelId: 'veo-3',
+  prompt: 'a timelapse of a city at dusk',
+  duration: 8,
+  audioEnabled: true,
+})
+
+// Poll yourself, later.
+const generation = await client.getGeneration(outputId)
+if (generation.status === 'completed') {
+  console.log(generation.outputUrls)
+}
+```
+
+`generateAndWait` does the polling for you and resolves with the finished `Generation` (or throws `GenerationFailedError` / `GenerationTimeoutError`). Tune it with `{ pollIntervalMs, timeoutMs, signal }`.
+
+Audio (ElevenLabs) is synchronous server-side, so `generate` returns `status: 'completed'` with `outputUrls` already populated.
+
+## The request envelope
+
+`modelId` is always required. Beyond that, a typed core of universal fields covers most needs, `references` carries image/video/frame inputs, and `parameters` is a passthrough for anything model-specific. Per-model capabilities are validated server-side, so an unsupported field for a given model comes back as a `ValidationError`.
+
+```ts
+// Image-to-image with a reference.
+await client.generate({
+  modelId: 'nano-banana-2',
+  prompt: 'turn this into a watercolor',
+  references: { images: ['https://...'] },
+})
+
+// Text-to-speech.
+await client.generate({
+  modelId: 'elevenlabs-tts',
+  text: 'Welcome to ContentHero.',
+  voiceId: 'your-voice-id',
+})
+```
+
+## Balance
+
+```ts
+const { balance, tier, autoTopupEnabled } = await client.getBalance()
+```
+
+## Errors
+
+Every non-2xx response maps to a typed error; all extend `ContentHeroError`.
+
+| Class | Status | Meaning |
+| --- | --- | --- |
+| `ValidationError` | 400 | Malformed or model-unsupported request |
+| `AuthenticationError` | 401 | Missing, revoked, or expired key |
+| `InsufficientCreditsError` | 402 | Not enough credits (carries `balance`, `required`) |
+| `PermissionError` | 403 | Key lacks the required scope |
+| `NotFoundError` | 404 | Unknown generation id |
+| `GenerationFailedError` | n/a | `generateAndWait` saw a terminal failure |
+| `GenerationTimeoutError` | n/a | `generateAndWait` exceeded `timeoutMs` |
+
+```ts
+import { InsufficientCreditsError } from '@contenthero/sdk'
+
+try {
+  await client.generateAndWait({ modelId: 'veo-3', prompt: '...' })
+} catch (err) {
+  if (err instanceof InsufficientCreditsError) {
+    console.error(`Need ${err.required}, have ${err.balance}`)
+  }
+}
+```
+
+## Configuration
+
+```ts
+new ContentHero({
+  apiKey: '...',                       // or CONTENTHERO_API_KEY
+  baseUrl: 'https://app.contenthero.ai', // or CONTENTHERO_BASE_URL
+  fetch: customFetch,                  // optional, defaults to global fetch
+})
+```

package/dist/client.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The ContentHero client: a thin, typed wrapper over the /api/v1 surface.
+ *
+ * Identity is the API key. The key resolves the owning account server-side, so
+ * the SDK never sends a user id. Generation is always-async on the wire; the
+ * SDK offers both a fire-and-forget `generate` and a `generateAndWait` that
+ * polls to a terminal state for you.
+ */
+import type { Avatar, AvatarSummary, Balance, BrandKit, BrandKitSummary, GenerateRequest, GenerateResult, Generation, ListMediaOptions, MediaItem, MediaSummary, ModelInfo, TranscribeRequest, Transcription, Voice, VoiceSummary, WaitOptions } from './types.js';
+/** Minimal fetch signature, so a custom implementation can be injected. */
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export interface ContentHeroOptions {
+    /**
+     * API key (`ch_live_...`). Falls back to the `CONTENTHERO_API_KEY`
+     * environment variable when omitted.
+     */
+    apiKey?: string;
+    /**
+     * API base URL. Falls back to `CONTENTHERO_BASE_URL`, then the production
+     * host. Override for self-hosted or preview environments.
+     */
+    baseUrl?: string;
+    /** Custom fetch implementation. Defaults to the global `fetch`. */
+    fetch?: FetchLike;
+}
+export declare class ContentHero {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(options?: ContentHeroOptions);
+    /**
+     * Submit a generation. Returns immediately. For image/video the result is
+     * `status: 'processing'` (poll with `getGeneration` or use `generateAndWait`);
+     * audio returns `status: 'completed'` with `outputUrls` populated.
+     */
+    generate(request: GenerateRequest): Promise<GenerateResult>;
+    /** Fetch the current state of a generation by its id. */
+    getGeneration(outputId: string): Promise<Generation>;
+    /**
+     * Submit a generation and poll until it reaches a terminal state. Resolves
+     * with the completed `Generation`, throws `GenerationFailedError` if it fails,
+     * or `GenerationTimeoutError` if it does not finish within `timeoutMs` (the
+     * server-side job may still complete; re-poll with `getGeneration`).
+     */
+    generateAndWait(request: GenerateRequest, options?: WaitOptions): Promise<Generation>;
+    /** Fetch the authenticated account's credit balance, tier, and auto-top-up state. */
+    getBalance(): Promise<Balance>;
+    /**
+     * Transcribe an audio URL to text (ElevenLabs Scribe). Synchronous: the
+     * transcript comes back inline. Free (no credit charge).
+     */
+    transcribe(request: TranscribeRequest): Promise<Transcription>;
+    /** List the account's avatars (the list half of the list+get pair). */
+    listAvatars(): Promise<AvatarSummary[]>;
+    /** Get one avatar with its looks (the get half). Throws NotFoundError if absent. */
+    getAvatar(avatarId: string): Promise<Avatar>;
+    /** List the account's saved voices (the list half of the list+get pair). */
+    listVoices(): Promise<VoiceSummary[]>;
+    /** Get one voice's detail (the get half). Throws NotFoundError if absent. */
+    getVoice(voiceId: string): Promise<Voice>;
+    /** List the account's brand kits (the list half of the list+get pair). */
+    listBrandKits(): Promise<BrandKitSummary[]>;
+    /** Get one brand kit, fully assembled (the get half). Throws NotFoundError if absent. */
+    getBrandKit(brandKitId: string): Promise<BrandKit>;
+    /** List the account's recent studio outputs (the list half of the list+get pair). */
+    listMedia(options?: ListMediaOptions): Promise<MediaSummary[]>;
+    /**
+     * Get one studio output by id token (the get half). The token may be the full
+     * output id, its first 8 characters, or either with a `-N` variation suffix
+     * (1-based). Throws NotFoundError if absent.
+     */
+    getMedia(idToken: string): Promise<MediaItem>;
+    /**
+     * List the models available to this key (the discovery catalog): which models
+     * exist, their content type and operation kind, and their capability surface.
+     * The source of truth for building model selections instead of hardcoding ids.
+     */
+    listModels(options?: {
+        contentType?: 'image' | 'video' | 'audio';
+    }): Promise<ModelInfo[]>;
+    /** Issue an authenticated request and map non-2xx responses to typed errors. */
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,OAAO,EACP,QAAQ,EACR,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,KAAK,EACL,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAA;AAEnB,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEhF,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAKD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;gBAEzB,OAAO,GAAE,kBAAuB;IAqB5C;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjE,yDAAyD;IACnD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAO1D;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqB/F,qFAAqF;IAC/E,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpE,uEAAuE;IACjE,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAK7C,oFAAoF;IAC9E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD,4EAA4E;IACtE,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK3C,6EAA6E;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI/C,0EAA0E;IACpE,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKjD,yFAAyF;IACnF,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxD,qFAAqF;IAC/E,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiBxE;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAInD;;;;OAIG;IACG,UAAU,CAAC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAMnG,gFAAgF;YAClE,OAAO;CA4BtB"}

package/dist/client.js

@@ -0,0 +1,190 @@
+/**
+ * The ContentHero client: a thin, typed wrapper over the /api/v1 surface.
+ *
+ * Identity is the API key. The key resolves the owning account server-side, so
+ * the SDK never sends a user id. Generation is always-async on the wire; the
+ * SDK offers both a fire-and-forget `generate` and a `generateAndWait` that
+ * polls to a terminal state for you.
+ */
+import { errorFromResponse, GenerationFailedError, GenerationTimeoutError } from './errors.js';
+const DEFAULT_BASE_URL = 'https://app.contenthero.ai';
+const TERMINAL = new Set(['completed', 'failed']);
+export class ContentHero {
+    apiKey;
+    baseUrl;
+    fetchImpl;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? readEnv('CONTENTHERO_API_KEY');
+        if (!apiKey) {
+            throw new Error('A ContentHero API key is required. Pass { apiKey } or set CONTENTHERO_API_KEY.');
+        }
+        const fetchImpl = options.fetch ?? globalThis.fetch;
+        if (!fetchImpl) {
+            throw new Error('No fetch implementation found. Use Node 20+ or pass a custom fetch via { fetch }.');
+        }
+        this.apiKey = apiKey;
+        this.baseUrl = (options.baseUrl ?? readEnv('CONTENTHERO_BASE_URL') ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.fetchImpl = fetchImpl;
+    }
+    /**
+     * Submit a generation. Returns immediately. For image/video the result is
+     * `status: 'processing'` (poll with `getGeneration` or use `generateAndWait`);
+     * audio returns `status: 'completed'` with `outputUrls` populated.
+     */
+    async generate(request) {
+        return this.request('POST', '/api/v1/studio/generate', request);
+    }
+    /** Fetch the current state of a generation by its id. */
+    async getGeneration(outputId) {
+        return this.request('GET', `/api/v1/studio/generate/${encodeURIComponent(outputId)}`);
+    }
+    /**
+     * Submit a generation and poll until it reaches a terminal state. Resolves
+     * with the completed `Generation`, throws `GenerationFailedError` if it fails,
+     * or `GenerationTimeoutError` if it does not finish within `timeoutMs` (the
+     * server-side job may still complete; re-poll with `getGeneration`).
+     */
+    async generateAndWait(request, options = {}) {
+        const { pollIntervalMs = 3000, timeoutMs = 600_000, signal } = options;
+        const submitted = await this.generate(request);
+        const deadline = Date.now() + timeoutMs;
+        while (true) {
+            const generation = await this.getGeneration(submitted.outputId);
+            if (generation.status === 'completed')
+                return generation;
+            if (generation.status === 'failed') {
+                throw new GenerationFailedError(generation.outputId, generation.error ?? 'Generation failed');
+            }
+            if (Date.now() >= deadline) {
+                throw new GenerationTimeoutError(submitted.outputId);
+            }
+            await sleep(pollIntervalMs, signal);
+        }
+    }
+    /** Fetch the authenticated account's credit balance, tier, and auto-top-up state. */
+    async getBalance() {
+        return this.request('GET', '/api/v1/account/balance');
+    }
+    /**
+     * Transcribe an audio URL to text (ElevenLabs Scribe). Synchronous: the
+     * transcript comes back inline. Free (no credit charge).
+     */
+    async transcribe(request) {
+        return this.request('POST', '/api/v1/studio/transcribe', request);
+    }
+    /** List the account's avatars (the list half of the list+get pair). */
+    async listAvatars() {
+        const data = await this.request('GET', '/api/v1/avatars');
+        return data.avatars;
+    }
+    /** Get one avatar with its looks (the get half). Throws NotFoundError if absent. */
+    async getAvatar(avatarId) {
+        return this.request('GET', `/api/v1/avatars/${encodeURIComponent(avatarId)}`);
+    }
+    /** List the account's saved voices (the list half of the list+get pair). */
+    async listVoices() {
+        const data = await this.request('GET', '/api/v1/voices');
+        return data.voices;
+    }
+    /** Get one voice's detail (the get half). Throws NotFoundError if absent. */
+    async getVoice(voiceId) {
+        return this.request('GET', `/api/v1/voices/${encodeURIComponent(voiceId)}`);
+    }
+    /** List the account's brand kits (the list half of the list+get pair). */
+    async listBrandKits() {
+        const data = await this.request('GET', '/api/v1/brand-kits');
+        return data.brandKits;
+    }
+    /** Get one brand kit, fully assembled (the get half). Throws NotFoundError if absent. */
+    async getBrandKit(brandKitId) {
+        return this.request('GET', `/api/v1/brand-kits/${encodeURIComponent(brandKitId)}`);
+    }
+    /** List the account's recent studio outputs (the list half of the list+get pair). */
+    async listMedia(options = {}) {
+        const q = new URLSearchParams();
+        if (options.contentType) {
+            const types = Array.isArray(options.contentType) ? options.contentType : [options.contentType];
+            q.set('contentType', types.join(','));
+        }
+        if (options.status)
+            q.set('status', options.status);
+        if (options.limit != null)
+            q.set('limit', String(options.limit));
+        if (options.offset != null)
+            q.set('offset', String(options.offset));
+        const qs = q.toString();
+        const data = await this.request('GET', `/api/v1/media${qs ? `?${qs}` : ''}`);
+        return data.media;
+    }
+    /**
+     * Get one studio output by id token (the get half). The token may be the full
+     * output id, its first 8 characters, or either with a `-N` variation suffix
+     * (1-based). Throws NotFoundError if absent.
+     */
+    async getMedia(idToken) {
+        return this.request('GET', `/api/v1/media/${encodeURIComponent(idToken)}`);
+    }
+    /**
+     * List the models available to this key (the discovery catalog): which models
+     * exist, their content type and operation kind, and their capability surface.
+     * The source of truth for building model selections instead of hardcoding ids.
+     */
+    async listModels(options = {}) {
+        const query = options.contentType ? `?contentType=${options.contentType}` : '';
+        const data = await this.request('GET', `/api/v1/models${query}`);
+        return data.models;
+    }
+    /** Issue an authenticated request and map non-2xx responses to typed errors. */
+    async request(method, path, body) {
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: 'application/json',
+        };
+        if (body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        const text = await response.text();
+        let data = undefined;
+        if (text) {
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = text;
+            }
+        }
+        if (!response.ok) {
+            throw errorFromResponse(response.status, data);
+        }
+        return data;
+    }
+}
+/** Read an env var without assuming `process` exists (keeps non-Node bundles happy). */
+function readEnv(name) {
+    const env = globalThis.process
+        ?.env;
+    return env?.[name];
+}
+/** Promise-based delay that rejects if the provided signal aborts. */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error('Aborted'));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new Error('Aborted'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# 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,80 @@
+/**
+ * Typed error hierarchy for the ContentHero SDK.
+ *
+ * Every non-2xx response from the API is mapped to one of these so callers can
+ * branch on `instanceof` rather than poking at status codes. `ContentHeroError`
+ * is the base; catch it to handle anything the SDK throws from a request.
+ */
+export interface ContentHeroErrorOptions {
+    status?: number;
+    /** The parsed response body (object or string), when there was one. */
+    body?: unknown;
+}
+/** Base class for every error thrown by the SDK. */
+export declare class ContentHeroError extends Error {
+    /** HTTP status code, when the error came from an API response. */
+    readonly status?: number;
+    /** The parsed response body, when available. */
+    readonly body?: unknown;
+    constructor(message: string, options?: ContentHeroErrorOptions);
+}
+/** 401: the API key is missing, malformed, revoked, or expired. */
+export declare class AuthenticationError extends ContentHeroError {
+    constructor(message?: string, options?: ContentHeroErrorOptions);
+}
+/** 403: the key is valid but lacks the scope required for this operation. */
+export declare class PermissionError extends ContentHeroError {
+    constructor(message?: string, options?: ContentHeroErrorOptions);
+}
+/** 400: the request was rejected as malformed or unsupported by the model. */
+export declare class ValidationError extends ContentHeroError {
+    constructor(message?: string, options?: ContentHeroErrorOptions);
+}
+/** 404: the referenced generation does not exist (or is not owned by this key). */
+export declare class NotFoundError extends ContentHeroError {
+    constructor(message?: string, options?: ContentHeroErrorOptions);
+}
+/**
+ * 402: the account does not have enough credits for the requested generation.
+ * Carries the current `balance` and the `required` amount when the API reports
+ * them, so callers can surface a precise top-up prompt.
+ */
+export declare class InsufficientCreditsError extends ContentHeroError {
+    readonly balance?: number;
+    readonly required?: number;
+    constructor(message?: string, options?: ContentHeroErrorOptions & {
+        balance?: number;
+        required?: number;
+    });
+}
+/**
+ * 429: the API key exceeded its per-minute request limit. `retryAfter` is the
+ * suggested wait in seconds when the API reports it, so callers can back off
+ * before retrying.
+ */
+export declare class RateLimitError extends ContentHeroError {
+    readonly retryAfter?: number;
+    constructor(message?: string, options?: ContentHeroErrorOptions & {
+        retryAfter?: number;
+    });
+}
+/**
+ * Thrown by `generateAndWait` when the generation reaches a terminal `failed`
+ * state. `outputId` lets the caller re-fetch the record for the error detail.
+ */
+export declare class GenerationFailedError extends ContentHeroError {
+    readonly outputId: string;
+    constructor(outputId: string, message?: string, options?: ContentHeroErrorOptions);
+}
+/**
+ * Thrown by `generateAndWait` when the generation does not reach a terminal
+ * state before the configured timeout. The job may still complete server-side;
+ * `outputId` lets the caller keep polling with `getGeneration`.
+ */
+export declare class GenerationTimeoutError extends ContentHeroError {
+    readonly outputId: string;
+    constructor(outputId: string, message?: string);
+}
+/** Map an HTTP status + parsed body onto the right typed error. */
+export declare function errorFromResponse(status: number, body: unknown): ContentHeroError;
+//# 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;;;;;;GAMG;AAEH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,oDAAoD;AACpD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;gBAEX,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;CAQ/D;AAED,mEAAmE;AACnE,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,OAAO,SAA0B,EAAE,OAAO,CAAC,EAAE,uBAAuB;CAIjF;AAED,6EAA6E;AAC7E,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,SAAsB,EAAE,OAAO,CAAC,EAAE,uBAAuB;CAI7E;AAED,8EAA8E;AAC9E,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,OAAO,SAAoB,EAAE,OAAO,CAAC,EAAE,uBAAuB;CAI3E;AAED,mFAAmF;AACnF,qBAAa,aAAc,SAAQ,gBAAgB;gBACrC,OAAO,SAAc,EAAE,OAAO,CAAC,EAAE,uBAAuB;CAIrE;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;gBAGxB,OAAO,SAAyB,EAChC,OAAO,CAAC,EAAE,uBAAuB,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;CAO9E;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;gBAG1B,OAAO,SAAwB,EAC/B,OAAO,CAAC,EAAE,uBAAuB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAM9D;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAsB,EAAE,OAAO,CAAC,EAAE,uBAAuB;CAK/F;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,SAA+C;CAKrF;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CA+BjF"}

package/dist/errors.js

@@ -0,0 +1,135 @@
+/**
+ * Typed error hierarchy for the ContentHero SDK.
+ *
+ * Every non-2xx response from the API is mapped to one of these so callers can
+ * branch on `instanceof` rather than poking at status codes. `ContentHeroError`
+ * is the base; catch it to handle anything the SDK throws from a request.
+ */
+/** Base class for every error thrown by the SDK. */
+export class ContentHeroError extends Error {
+    /** HTTP status code, when the error came from an API response. */
+    status;
+    /** The parsed response body, when available. */
+    body;
+    constructor(message, options) {
+        super(message);
+        this.name = 'ContentHeroError';
+        this.status = options?.status;
+        this.body = options?.body;
+        // Preserve the prototype chain when compiled down to ES targets.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** 401: the API key is missing, malformed, revoked, or expired. */
+export class AuthenticationError extends ContentHeroError {
+    constructor(message = 'Authentication failed', options) {
+        super(message, options);
+        this.name = 'AuthenticationError';
+    }
+}
+/** 403: the key is valid but lacks the scope required for this operation. */
+export class PermissionError extends ContentHeroError {
+    constructor(message = 'Permission denied', options) {
+        super(message, options);
+        this.name = 'PermissionError';
+    }
+}
+/** 400: the request was rejected as malformed or unsupported by the model. */
+export class ValidationError extends ContentHeroError {
+    constructor(message = 'Invalid request', options) {
+        super(message, options);
+        this.name = 'ValidationError';
+    }
+}
+/** 404: the referenced generation does not exist (or is not owned by this key). */
+export class NotFoundError extends ContentHeroError {
+    constructor(message = 'Not found', options) {
+        super(message, options);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * 402: the account does not have enough credits for the requested generation.
+ * Carries the current `balance` and the `required` amount when the API reports
+ * them, so callers can surface a precise top-up prompt.
+ */
+export class InsufficientCreditsError extends ContentHeroError {
+    balance;
+    required;
+    constructor(message = 'Insufficient credits', options) {
+        super(message, options);
+        this.name = 'InsufficientCreditsError';
+        this.balance = options?.balance;
+        this.required = options?.required;
+    }
+}
+/**
+ * 429: the API key exceeded its per-minute request limit. `retryAfter` is the
+ * suggested wait in seconds when the API reports it, so callers can back off
+ * before retrying.
+ */
+export class RateLimitError extends ContentHeroError {
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', options) {
+        super(message, options);
+        this.name = 'RateLimitError';
+        this.retryAfter = options?.retryAfter;
+    }
+}
+/**
+ * Thrown by `generateAndWait` when the generation reaches a terminal `failed`
+ * state. `outputId` lets the caller re-fetch the record for the error detail.
+ */
+export class GenerationFailedError extends ContentHeroError {
+    outputId;
+    constructor(outputId, message = 'Generation failed', options) {
+        super(message, options);
+        this.name = 'GenerationFailedError';
+        this.outputId = outputId;
+    }
+}
+/**
+ * Thrown by `generateAndWait` when the generation does not reach a terminal
+ * state before the configured timeout. The job may still complete server-side;
+ * `outputId` lets the caller keep polling with `getGeneration`.
+ */
+export class GenerationTimeoutError extends ContentHeroError {
+    outputId;
+    constructor(outputId, message = 'Timed out waiting for generation to finish') {
+        super(message);
+        this.name = 'GenerationTimeoutError';
+        this.outputId = outputId;
+    }
+}
+/** Map an HTTP status + parsed body onto the right typed error. */
+export function errorFromResponse(status, body) {
+    const record = (body && typeof body === 'object' ? body : undefined);
+    const message = (record && typeof record.error === 'string' && record.error) ||
+        (typeof body === 'string' && body) ||
+        `Request failed with status ${status}`;
+    const options = { status, body };
+    switch (status) {
+        case 400:
+            return new ValidationError(message, options);
+        case 401:
+            return new AuthenticationError(message, options);
+        case 402:
+            return new InsufficientCreditsError(message, {
+                ...options,
+                balance: typeof record?.balance === 'number' ? record.balance : undefined,
+                required: typeof record?.required === 'number' ? record.required : undefined,
+            });
+        case 403:
+            return new PermissionError(message, options);
+        case 404:
+            return new NotFoundError(message, options);
+        case 429:
+            return new RateLimitError(message, {
+                ...options,
+                retryAfter: typeof record?.retryAfter === 'number' ? record.retryAfter : undefined,
+            });
+        default:
+            return new ContentHeroError(message, options);
+    }
+}
+//# 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,12 @@
+/**
+ * @contenthero/sdk
+ *
+ * Official SDK for the ContentHero Studio API: programmatic image, video, and
+ * audio generation. The shared kernel the ContentHero MCP and CLI sit on.
+ */
+export { ContentHero } from './client.js';
+export type { ContentHeroOptions, FetchLike } from './client.js';
+export type { References, GenerateRequest, GenerateResult, Generation, GenerationStatus, Balance, SubscriptionTier, WaitOptions, ModelKind, ModelCapabilities, ModelInfo, TranscribeRequest, Transcription, AvatarSummary, AvatarLook, Avatar, VoiceSummary, Voice, BrandKitSummary, BrandKitAccount, BrandKitSection, BrandKitKnowledge, BrandKit, MediaType, MediaVariation, MediaSummary, MediaItem, ListMediaOptions, } from './types.js';
+export { ContentHeroError, AuthenticationError, PermissionError, ValidationError, NotFoundError, InsufficientCreditsError, RateLimitError, GenerationFailedError, GenerationTimeoutError, } from './errors.js';
+export type { ContentHeroErrorOptions } from './errors.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;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAChE,YAAY,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,UAAU,EACV,MAAM,EACN,YAAY,EACZ,KAAK,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @contenthero/sdk
+ *
+ * Official SDK for the ContentHero Studio API: programmatic image, video, and
+ * audio generation. The shared kernel the ContentHero MCP and CLI sit on.
+ */
+export { ContentHero } from './client.js';
+export { ContentHeroError, AuthenticationError, PermissionError, ValidationError, NotFoundError, InsufficientCreditsError, RateLimitError, GenerationFailedError, GenerationTimeoutError, } from './errors.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;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAgCzC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,aAAa,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Public request/response types for the ContentHero SDK.
+ *
+ * These mirror the server contract in the ContentHero app
+ * (lib/studio/v1-request.ts and the /api/v1 route responses). The request is a
+ * thin envelope: a typed core of universal fields, a `references` object, and a
+ * model-specific `parameters` passthrough for the long tail. Per-model
+ * capabilities (which models accept which fields) are validated server-side
+ * against the same registry that drives the Studio UI.
+ */
+/**
+ * Reference inputs (image-to-image, video-to-video, frame conditioning).
+ *
+ * Every value may be either a media URL OR one of your own output ids, so you
+ * can chain generations: pass a previous generation's id and the server
+ * substitutes that output's URL (ownership-checked). The id may be the full
+ * output id, its first 8 characters, or either with a `-N` variation suffix
+ * (1-based), e.g. `"a1b2c3d4-2"`. Without a suffix the first variation is used.
+ */
+export interface References {
+    /** Image references / image-to-image inputs (URL or output id). */
+    images?: string[];
+    /** Video references, e.g. video-to-video models (URL or output id). */
+    videos?: string[];
+    /** Audio references, e.g. lip-sync custom audio input (URL or output id). */
+    audio?: string[];
+    /** First frame for video models that accept one (URL or output id). */
+    startFrame?: string;
+    /** Last frame for video models that accept one (URL or output id). */
+    endFrame?: string;
+}
+/**
+ * A generation request. `modelId` is always required. For image/video the
+ * `prompt` and typed-core fields apply; for audio (ElevenLabs) the audio fields
+ * apply. Anything a specific model supports beyond the typed core can be passed
+ * through `parameters`.
+ */
+export interface GenerateRequest {
+    /** Media kind. Optional: inferred from the model when omitted. */
+    contentType?: 'image' | 'video' | 'audio';
+    /** Model identifier, e.g. 'nano-banana-2'. Required. */
+    modelId: string;
+    /** Text prompt. Required for image/video and for music/sfx audio. */
+    prompt?: string;
+    aspectRatio?: string;
+    resolution?: string;
+    /** Quality mode for models that expose it separately (e.g. GPT Image). */
+    quality?: string;
+    /** Number of images to produce (image models). */
+    numImages?: number;
+    /** Number of variations to produce (video models). */
+    numGenerations?: number;
+    /** Clip duration in seconds (video models). */
+    duration?: number;
+    /** Enable generated audio on video models that support it. */
+    audioEnabled?: boolean;
+    negativePrompt?: string;
+    seed?: number;
+    /** Upscale factor for upscale models, e.g. "2x", "4x" (validated per model). */
+    upscaleFactor?: string;
+    references?: References;
+    /** Model-specific parameters passed through to the provider (long tail). */
+    parameters?: Record<string, unknown>;
+    /** Text to speak (text-to-speech). */
+    text?: string;
+    /** ElevenLabs voice id (text-to-speech). */
+    voiceId?: string;
+    /** Human-readable voice name, stored for display (text-to-speech). */
+    voiceName?: string;
+    /** Duration in seconds (music / sound effects). */
+    durationSeconds?: number;
+    /** How literally to follow the prompt, 0.0 to 1.0 (sound effects). */
+    promptInfluence?: number;
+    /**
+     * Optional client-chosen id for idempotency. Must be a UUID; it becomes the
+     * generation's id. Re-submitting with the same id returns the existing job
+     * instead of starting (and charging for) another, so retries are safe. You
+     * also know the id up front and can poll `getGeneration` immediately.
+     */
+    outputId?: string;
+}
+/** Lifecycle state of a generation. */
+export type GenerationStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/**
+ * Result of submitting a generation. Image/video return `status: 'processing'`
+ * (poll with `getGeneration`, or use `generateAndWait`). Audio is synchronous
+ * and returns `status: 'completed'` with `outputUrls` already populated.
+ */
+export interface GenerateResult {
+    outputId: string;
+    status: 'processing' | 'completed';
+    /** Estimated credit cost computed server-side. */
+    creditsEstimate?: number;
+    /** Present when the result is already complete (audio). */
+    outputUrls?: string[];
+    /** True when a client-supplied `outputId` matched an existing job (no new work was started). */
+    idempotentReplay?: boolean;
+}
+/** A generation record as returned by `getGeneration` and `generateAndWait`. */
+export interface Generation {
+    outputId: string;
+    status: GenerationStatus;
+    contentType: 'image' | 'video' | 'audio';
+    modelId: string;
+    /** Output asset URLs. Empty until the generation completes. */
+    outputUrls: string[];
+    /** Error detail when `status` is 'failed', otherwise null. */
+    error: string | null;
+    createdAt: string;
+    completedAt: string | null;
+}
+/** Subscription tiers the API normalizes balances against. */
+export type SubscriptionTier = 'mortal' | 'hero' | 'champion' | 'legend';
+/** Account credit standing as returned by `getBalance`. */
+export interface Balance {
+    balance: number;
+    tier: SubscriptionTier;
+    autoTopupEnabled: boolean;
+}
+/** Options for `generateAndWait`'s polling behavior. */
+export interface WaitOptions {
+    /** Milliseconds between status polls. Default 3000. */
+    pollIntervalMs?: number;
+    /** Give up after this many milliseconds. Default 600000 (10 minutes). */
+    timeoutMs?: number;
+    /** Abort the wait (does not cancel the server-side job). */
+    signal?: AbortSignal;
+}
+/** Request to transcribe an audio URL to text. */
+export interface TranscribeRequest {
+    /** Public URL of the audio to transcribe. */
+    audioUrl: string;
+    /** Optional ISO language hint (e.g. "en"); auto-detected when omitted. */
+    languageCode?: string;
+    /** Label each speaker (diarization). */
+    diarize?: boolean;
+}
+/** Result of transcribing audio. Synchronous (no polling). */
+export interface Transcription {
+    outputId: string;
+    transcript: string;
+    language: string;
+    wordCount: number;
+    /** Source audio length in seconds, when known. */
+    durationSeconds: number | null;
+}
+/** An avatar as returned by `listAvatars` (the list projection). */
+export interface AvatarSummary {
+    id: string;
+    name: string;
+    /** The avatar's base image (profile photo); the default look for lip-sync. */
+    imageUrl: string | null;
+    defaultVoiceId: string | null;
+    isDefault: boolean;
+    status: string;
+}
+/** An outfit/look variation of an avatar. */
+export interface AvatarLook {
+    id: string;
+    name: string | null;
+    imageUrl: string | null;
+    lookType: string | null;
+    isDefault: boolean;
+}
+/** Full avatar detail as returned by `getAvatar`. */
+export interface Avatar extends AvatarSummary {
+    description: string | null;
+    age: string | null;
+    gender: string | null;
+    ethnicity: string | null;
+    niche: string[];
+    createdAt: string | null;
+    looks: AvatarLook[];
+}
+/** A voice as returned by `listVoices` (the list projection). */
+export interface VoiceSummary {
+    voiceId: string;
+    name: string | null;
+    provider: string | null;
+    isFavorited: boolean;
+    previewUrl: string | null;
+    lastUsedAt: string | null;
+}
+/** Full voice detail as returned by `getVoice`. */
+export interface Voice extends VoiceSummary {
+    accent: string | null;
+    language: string | null;
+    gender: string | null;
+    age: string | null;
+    description: string | null;
+    useCase: string | null;
+}
+/** A brand kit as returned by `listBrandKits` (the list projection). */
+export interface BrandKitSummary {
+    id: string;
+    name: string;
+    businessName: string | null;
+    nicheDefinition: string | null;
+    isDefault: boolean;
+    isActive: boolean;
+    isFavorited: boolean;
+    isArchived: boolean;
+    createdAt: string | null;
+}
+/** A brand/inspiration account linked to a brand kit. */
+export interface BrandKitAccount {
+    platform: string | null;
+    name: string | null;
+    handle: string | null;
+    avatarUrl: string | null;
+    followerCount: number | null;
+}
+/** A curated section of a brand kit (overview / voice tabs). */
+export interface BrandKitSection {
+    tab: string;
+    sectionName: string;
+    sortOrder: number;
+    /** Field objects: { key, label, type, value }. */
+    fields: unknown[];
+}
+/** A knowledge-base item (body truncated to a preview). */
+export interface BrandKitKnowledge {
+    id: string;
+    title: string | null;
+    sourceType: string | null;
+    sourceUrl: string | null;
+    contentPreview: string | null;
+}
+/** Full brand kit as returned by `getBrandKit` (the whole document). */
+export interface BrandKit extends BrandKitSummary {
+    websiteUrl: string | null;
+    sourceType: string | null;
+    primaryOffer: string | null;
+    positioning: Record<string, unknown> | null;
+    audience: Record<string, unknown> | null;
+    voiceProfile: Record<string, unknown> | null;
+    logos: unknown[];
+    brandColors: unknown[];
+    typography: Record<string, unknown> | null;
+    visualStyle: string | null;
+    designPrinciples: string[];
+    socialAccounts: unknown[];
+    contentStrategy: Record<string, unknown> | null;
+    assets: unknown[];
+    sections: BrandKitSection[];
+    brandAccounts: BrandKitAccount[];
+    inspirationAccounts: BrandKitAccount[];
+    knowledge: BrandKitKnowledge[];
+}
+/** A studio output's media kind. */
+export type MediaType = 'image' | 'video' | 'audio' | 'transcript';
+/** One variation (slot) of a studio output. */
+export interface MediaVariation {
+    /** 1-based variation number (matches the UI and a share link's ?v=N). */
+    variation: number;
+    url: string | null;
+    status: string;
+    isFavorited: boolean;
+}
+/** A studio output as returned by `listMedia` (the list projection). */
+export interface MediaSummary {
+    id: string;
+    type: MediaType;
+    model: string | null;
+    prompt: string | null;
+    status: string;
+    createdAt: string | null;
+    variationCount: number;
+    /** Resolved (non-null) variation URLs. */
+    urls: string[];
+}
+/** Full studio output detail as returned by `getMedia`. */
+export interface MediaItem extends MediaSummary {
+    script: string | null;
+    aspectRatio: string | null;
+    resolution: string | null;
+    duration: number | null;
+    creditsUsed: number | null;
+    variations: MediaVariation[];
+    /** Set when the requested token addressed a single variation; else null. */
+    selectedVariation: number | null;
+}
+/** Options for `listMedia`. */
+export interface ListMediaOptions {
+    contentType?: MediaType | MediaType[];
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+/** The operation a model performs within its content type. */
+export type ModelKind = 'generate' | 'upscale' | 'lip-sync' | 'voice';
+/**
+ * A model's capability surface, as advertised by the discovery endpoint. Typed
+ * loosely (an index signature for the long tail) because the full contract is
+ * validated server-side; the fields below are the stable ones clients reason
+ * about.
+ */
+export interface ModelCapabilities {
+    kind: ModelKind;
+    outputType: 'image' | 'video' | 'audio' | 'text' | 'voice';
+    promptMode: 'required' | 'optional' | 'none';
+    [key: string]: unknown;
+}
+/** A model in the discovery catalog returned by `listModels`. */
+export interface ModelInfo {
+    modelId: string;
+    displayName: string;
+    description: string | null;
+    contentType: 'image' | 'video' | 'audio';
+    kind: ModelKind;
+    tags: string[];
+    capabilities: ModelCapabilities;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IACzC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAA;IAGf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,UAAU,CAAA;IAEvB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAGpC,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEhF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,YAAY,GAAG,WAAW,CAAA;IAClC,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,gBAAgB,CAAA;IACxB,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAA;AAExE,2DAA2D;AAC3D,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,gBAAgB,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,MAAO,SAAQ,aAAa;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,mDAAmD;AACnD,MAAM,WAAW,KAAM,SAAQ,YAAY;IACzC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,wEAAwE;AACxE,MAAM,WAAW,QAAS,SAAQ,eAAe;IAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC5C,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,WAAW,EAAE,OAAO,EAAE,CAAA;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,cAAc,EAAE,OAAO,EAAE,CAAA;IACzB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC/C,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,aAAa,EAAE,eAAe,EAAE,CAAA;IAChC,mBAAmB,EAAE,eAAe,EAAE,CAAA;IACtC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAC/B;AAED,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAA;AAElE,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,4EAA4E;IAC5E,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;AAErE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAA;IACf,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1D,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IACxC,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,YAAY,EAAE,iBAAiB,CAAA;CAChC"}

package/dist/types.js

@@ -0,0 +1,12 @@
+/**
+ * Public request/response types for the ContentHero SDK.
+ *
+ * These mirror the server contract in the ContentHero app
+ * (lib/studio/v1-request.ts and the /api/v1 route responses). The request is a
+ * thin envelope: a typed core of universal fields, a `references` object, and a
+ * model-specific `parameters` passthrough for the long tail. Per-model
+ * capabilities (which models accept which fields) are validated server-side
+ * against the same registry that drives the Studio UI.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@contenthero/sdk",
+  "version": "0.1.0",
+  "description": "Official ContentHero SDK. Programmatic media generation (image, video, audio) on the ContentHero Studio API. The shared kernel the ContentHero MCP and CLI sit on.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "tsx --test \"src/**/*.test.ts\"",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/contenthero-ai/contenthero-packages.git",
+    "directory": "packages/sdk"
+  },
+  "keywords": [
+    "contenthero",
+    "ai",
+    "image-generation",
+    "video-generation",
+    "text-to-speech",
+    "generative-media",
+    "sdk"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "private": false,
+  "devDependencies": {
+    "@types/node": "^22.19.19",
+    "tsx": "^4.22.3"
+  }
+}