creacortex 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Creacortex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# creacortex
+
+Node / TypeScript client for the **Creacortex** video-creative attention-analysis API.
+
+Upload a video creative, run it through the pipeline, and pull back per-second
+attention data, a Gen-AI optimization payload, and PDF reports. Works in Node 18+
+(global `fetch`) and modern browsers.
+
+## Install
+
+```bash
+npm install creacortex
+```
+
+## Quick start
+
+```ts
+import { Creacortex } from "creacortex";
+
+const cx = new Creacortex("ace_your_api_key");
+
+// one call: upload + start + wait for completion
+const run = await cx.analyze("ad.mp4", { withAudio: true, creativeId: "summer-promo" });
+
+const csv = await cx.getCsv(run.runId);                  // Uint8Array — per-second analysis
+const payload = await cx.getExport(run.runId);           // Gen-AI insights (JSON)
+const pdf = await cx.getReport(run.runId, "diagnose");   // Uint8Array — PDF report
+```
+
+Get an API key from **Usage & billing → API keys** in the dashboard. It is sent as
+the `X-API-Key` header.
+
+`analyze` / `uploadVideo` accept a file path (Node), a `Blob`/`File` (browser), or raw
+bytes (`Uint8Array` / `ArrayBuffer`).
+
+## Calibration
+
+Improve prediction accuracy (and unlock all metrics) by calibrating on your real performance data.
+Any CSV works — map your columns to our fields:
+
+```ts
+const csv = await readFile("performance.csv");
+const a = (await cx.calibrationAnalyze(csv)) as { guess: Record<string, string> };
+const mapping = { ...a.guess, creative_id: "Ad name" };       // adjust if needed
+await cx.calibrationPreview(csv, mapping, 50000);              // cost + impression split
+await cx.calibrationCommit(csv, mapping, { processUnmatched: true });  // charge + fit
+
+(await cx.getAccount()).calibrated;   // true once fitted
+```
+
+## Step by step
+
+```ts
+const videoId = await cx.uploadVideo("ad.mp4");
+let run = await cx.createRun(videoId, { withAudio: true, audience: "men 20-45, mobile gamers" });
+run = await cx.wait(run.runId);            // poll until done (or throws RunFailedError / WaitTimeout)
+
+for (const item of await cx.listRuns()) console.log(item.runId, item.status, item.ready);
+console.log((await cx.getAccount()).balance);   // credits left
+```
+
+## Errors
+
+| Class | When |
+|---|---|
+| `AuthError` | invalid/missing API key (401) |
+| `InsufficientCreditsError` | not enough credits (402) |
+| `RateLimitError` | too many requests (429) |
+| `NotFoundError` | unknown run (404) |
+| `RunFailedError` | the run finished with `status: "failed"` |
+| `WaitTimeout` | `wait()` exceeded its timeout |
+| `ApiError` | any other HTTP error (has `.status`) |
+
+All extend `CreacortexError`.
+
+## Options
+
+```ts
+new Creacortex("ace_...", {
+  baseUrl: "https://api.creacortex.ai",
+  timeoutMs: 60_000,
+  fetch: customFetch,   // optional: inject a fetch implementation
+});
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,309 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ApiError: () => ApiError,
+  AuthError: () => AuthError,
+  Creacortex: () => Creacortex,
+  CreacortexError: () => CreacortexError,
+  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  InsufficientCreditsError: () => InsufficientCreditsError,
+  NotFoundError: () => NotFoundError,
+  RateLimitError: () => RateLimitError,
+  RunFailedError: () => RunFailedError,
+  WaitTimeout: () => WaitTimeout
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var CreacortexError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CreacortexError";
+  }
+};
+var ApiError = class extends CreacortexError {
+  status;
+  constructor(status, message) {
+    super(`[${status}] ${message}`);
+    this.name = "ApiError";
+    this.status = status;
+  }
+};
+var AuthError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "AuthError";
+  }
+};
+var InsufficientCreditsError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "InsufficientCreditsError";
+  }
+};
+var RateLimitError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "RateLimitError";
+  }
+};
+var NotFoundError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "NotFoundError";
+  }
+};
+var RunFailedError = class extends CreacortexError {
+  runId;
+  cause;
+  constructor(runId, cause) {
+    super(`run ${runId} failed: ${cause ?? "unknown error"}`);
+    this.name = "RunFailedError";
+    this.runId = runId;
+    this.cause = cause;
+  }
+};
+var WaitTimeout = class extends CreacortexError {
+  constructor(message) {
+    super(message);
+    this.name = "WaitTimeout";
+  }
+};
+var BY_STATUS = {
+  401: AuthError,
+  402: InsufficientCreditsError,
+  404: NotFoundError,
+  429: RateLimitError
+};
+async function raiseForStatus(res) {
+  if (res.ok) return;
+  const detail = await readDetail(res);
+  const Cls = BY_STATUS[res.status] ?? ApiError;
+  throw new Cls(res.status, detail);
+}
+async function readDetail(res) {
+  const text = await res.text();
+  try {
+    const body = JSON.parse(text);
+    if (body && typeof body === "object" && "detail" in body) return String(body.detail);
+    return text;
+  } catch {
+    return text || res.statusText;
+  }
+}
+
+// src/models.ts
+function runFromApi(d) {
+  return {
+    runId: String(d.run_id),
+    status: d.status,
+    creativeId: d.creative_id ?? null,
+    withAudio: Boolean(d.with_audio),
+    error: d.error ?? null,
+    ready: Boolean(d.ready),
+    csvUrl: d.csv_url ?? null,
+    exportUrl: d.export_url ?? null,
+    diagnosePdfUrl: d.diagnose_pdf_url ?? null,
+    analyzePdfUrl: d.analyze_pdf_url ?? null
+  };
+}
+function runListItemFromApi(d) {
+  return {
+    runId: String(d.run_id),
+    status: d.status,
+    creativeId: d.creative_id ?? null,
+    withAudio: Boolean(d.with_audio),
+    ready: Boolean(d.ready),
+    createdAt: String(d.created_at)
+  };
+}
+function accountFromApi(d) {
+  return {
+    project: d.project ?? null,
+    balance: Number(d.balance),
+    quota: Number(d.quota),
+    used: Number(d.used ?? 0),
+    calibrated: Boolean(d.calibrated)
+  };
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.creacortex.ai";
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function toBlob(file, contentType) {
+  if (typeof file === "string") {
+    const { readFile } = await import("fs/promises");
+    const { basename } = await import("path");
+    const buf = await readFile(file);
+    return { blob: new Blob([buf], { type: contentType }), name: basename(file) };
+  }
+  if (file instanceof Blob) {
+    const named = file;
+    return { blob: file, name: named.name ?? "video.mp4" };
+  }
+  return { blob: new Blob([file], { type: contentType }), name: "video.mp4" };
+}
+var Creacortex = class {
+  key;
+  base;
+  timeoutMs;
+  fetchImpl;
+  constructor(apiKey, opts = {}) {
+    if (!apiKey) throw new Error("apiKey is required");
+    this.key = apiKey;
+    this.base = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeoutMs = opts.timeoutMs ?? 6e4;
+    const f = opts.fetch ?? globalThis.fetch;
+    if (!f) throw new Error("global fetch is unavailable \u2014 pass options.fetch");
+    this.fetchImpl = f;
+  }
+  async req(path, init = {}) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    try {
+      const headers = { "X-API-Key": this.key, ...init.headers };
+      return await this.fetchImpl(this.base + path, { ...init, headers, signal: ctrl.signal });
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async json(res) {
+    await raiseForStatus(res);
+    return await res.json();
+  }
+  async bytes(res) {
+    await raiseForStatus(res);
+    return new Uint8Array(await res.arrayBuffer());
+  }
+  async uploadVideo(file, opts = {}) {
+    const { blob, name } = await toBlob(file, opts.contentType ?? "video/mp4");
+    const form = new FormData();
+    form.append("file", blob, opts.filename ?? name);
+    const res = await this.req("/v1/videos", { method: "POST", body: form });
+    return String((await this.json(res)).video_id);
+  }
+  async createRun(videoId, opts = {}) {
+    const body = JSON.stringify({
+      video_id: videoId,
+      creative_id: opts.creativeId ?? null,
+      with_audio: opts.withAudio ?? false,
+      audience: opts.audience ?? null
+    });
+    const res = await this.req("/v1/runs", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body
+    });
+    return runFromApi(await this.json(res));
+  }
+  async getRun(runId) {
+    return runFromApi(await this.json(await this.req(`/v1/runs/${runId}`)));
+  }
+  async listRuns() {
+    const arr = await this.json(await this.req("/v1/runs"));
+    return arr.map(runListItemFromApi);
+  }
+  async getAccount() {
+    return accountFromApi(await this.json(await this.req("/v1/account")));
+  }
+  async calibForm(file, filename) {
+    const { blob, name } = await toBlob(file, "text/csv");
+    const form = new FormData();
+    form.append("file", blob, filename ?? name);
+    return form;
+  }
+  /** Step 1: detect columns and a guessed mapping for a performance CSV. */
+  async calibrationAnalyze(file, filename = "data.csv") {
+    const form = await this.calibForm(file, filename);
+    return this.json(await this.req("/v1/calibration/analyze", { method: "POST", body: form }));
+  }
+  /** Step 2: summary (impression split, matched/processable, cost) — no charge. */
+  async calibrationPreview(file, mapping, minImpressions = 0, filename = "data.csv") {
+    const form = await this.calibForm(file, filename);
+    form.append("mapping", JSON.stringify(mapping));
+    form.append("min_impressions", String(minImpressions));
+    return this.json(await this.req("/v1/calibration/preview", { method: "POST", body: form }));
+  }
+  /** Step 3: charge, store actuals, fit calibration, queue unmatched videos. */
+  async calibrationCommit(file, mapping, opts = {}) {
+    const form = await this.calibForm(file, opts.filename ?? "data.csv");
+    form.append("mapping", JSON.stringify(mapping));
+    form.append("min_impressions", String(opts.minImpressions ?? 0));
+    form.append("process_unmatched", String(opts.processUnmatched ?? false));
+    return this.json(await this.req("/v1/calibration/commit", { method: "POST", body: form }));
+  }
+  /** Per-second analysis CSV (raw bytes). */
+  async getCsv(runId) {
+    return this.bytes(await this.req(`/v1/runs/${runId}/data.csv`));
+  }
+  /** Gen-AI payload (parsed JSON). */
+  async getExport(runId) {
+    return this.json(await this.req(`/v1/runs/${runId}/export.json`));
+  }
+  /** PDF report bytes. kind is "diagnose" or "analyze". */
+  async getReport(runId, kind = "diagnose") {
+    return this.bytes(await this.req(`/v1/runs/${runId}/report.pdf?kind=${encodeURIComponent(kind)}`));
+  }
+  /** Poll until the run reaches a terminal state. Rejects on failure/timeout. */
+  async wait(runId, opts = {}) {
+    const intervalMs = opts.intervalMs ?? 5e3;
+    const deadline = Date.now() + (opts.timeoutMs ?? 18e5);
+    for (; ; ) {
+      const run = await this.getRun(runId);
+      if (run.status === "failed") throw new RunFailedError(run.runId, run.error ?? void 0);
+      if (run.status === "done") return run;
+      if (Date.now() >= deadline) throw new WaitTimeout(`run ${runId} not done in time`);
+      await sleep(intervalMs);
+    }
+  }
+  /** Upload, start a run, and (by default) wait for it to finish. */
+  async analyze(file, opts = {}) {
+    const videoId = await this.uploadVideo(file, { filename: opts.filename });
+    const run = await this.createRun(videoId, opts);
+    if (opts.wait === false) return run;
+    return this.wait(run.runId, opts);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiError,
+  AuthError,
+  Creacortex,
+  CreacortexError,
+  DEFAULT_BASE_URL,
+  InsufficientCreditsError,
+  NotFoundError,
+  RateLimitError,
+  RunFailedError,
+  WaitTimeout
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/models.ts","../src/client.ts"],"sourcesContent":["export { Creacortex, DEFAULT_BASE_URL } from \"./client\";\nexport type {\n  AnalyzeOptions,\n  ClientOptions,\n  CreateRunOptions,\n  FileInput,\n  UploadOptions,\n  WaitOptions,\n} from \"./client\";\nexport type { Account, Run, RunListItem, RunStatus } from \"./models\";\nexport {\n  ApiError,\n  AuthError,\n  CreacortexError,\n  InsufficientCreditsError,\n  NotFoundError,\n  RateLimitError,\n  RunFailedError,\n  WaitTimeout,\n} from \"./errors\";\n","/** Errors thrown by the Creacortex client. */\n\nexport class CreacortexError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CreacortexError\";\n  }\n}\n\n/** An HTTP error returned by the API (status >= 400). */\nexport class ApiError extends CreacortexError {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(`[${status}] ${message}`);\n    this.name = \"ApiError\";\n    this.status = status;\n  }\n}\n\n/** Invalid or missing API key (401). */\nexport class AuthError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"AuthError\";\n  }\n}\n\n/** Not enough credits to run the analysis (402). */\nexport class InsufficientCreditsError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"InsufficientCreditsError\";\n  }\n}\n\n/** Too many requests (429). */\nexport class RateLimitError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"RateLimitError\";\n  }\n}\n\n/** Unknown run or resource (404). */\nexport class NotFoundError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/** The run finished with status=\"failed\". */\nexport class RunFailedError extends CreacortexError {\n  readonly runId: string;\n  readonly cause?: string;\n\n  constructor(runId: string, cause?: string) {\n    super(`run ${runId} failed: ${cause ?? \"unknown error\"}`);\n    this.name = \"RunFailedError\";\n    this.runId = runId;\n    this.cause = cause;\n  }\n}\n\n/** A run did not finish within the wait timeout. */\nexport class WaitTimeout extends CreacortexError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"WaitTimeout\";\n  }\n}\n\nconst BY_STATUS: Record<number, new (s: number, m: string) => ApiError> = {\n  401: AuthError,\n  402: InsufficientCreditsError,\n  404: NotFoundError,\n  429: RateLimitError,\n};\n\n/** Throw the appropriate typed error for a non-OK response. */\nexport async function raiseForStatus(res: Response): Promise<void> {\n  if (res.ok) return;\n  const detail = await readDetail(res);\n  const Cls = BY_STATUS[res.status] ?? ApiError;\n  throw new Cls(res.status, detail);\n}\n\nasync function readDetail(res: Response): Promise<string> {\n  const text = await res.text();\n  try {\n    const body = JSON.parse(text);\n    if (body && typeof body === \"object\" && \"detail\" in body) return String(body.detail);\n    return text;\n  } catch {\n    return text || res.statusText;\n  }\n}\n","/** Typed response models (camelCase), mapped from the API's snake_case JSON. */\n\nexport type RunStatus = \"queued\" | \"running\" | \"done\" | \"failed\";\n\nexport interface Run {\n  runId: string;\n  status: RunStatus;\n  creativeId?: string | null;\n  withAudio: boolean;\n  error?: string | null;\n  ready: boolean;\n  csvUrl?: string | null;\n  exportUrl?: string | null;\n  diagnosePdfUrl?: string | null;\n  analyzePdfUrl?: string | null;\n}\n\nexport interface RunListItem {\n  runId: string;\n  status: RunStatus;\n  creativeId?: string | null;\n  withAudio: boolean;\n  ready: boolean;\n  createdAt: string;\n}\n\nexport interface Account {\n  project?: string | null;\n  balance: number;\n  quota: number;\n  used: number;\n  calibrated: boolean;\n}\n\ntype Json = Record<string, unknown>;\n\nexport function runFromApi(d: Json): Run {\n  return {\n    runId: String(d.run_id),\n    status: d.status as RunStatus,\n    creativeId: (d.creative_id as string | null) ?? null,\n    withAudio: Boolean(d.with_audio),\n    error: (d.error as string | null) ?? null,\n    ready: Boolean(d.ready),\n    csvUrl: (d.csv_url as string | null) ?? null,\n    exportUrl: (d.export_url as string | null) ?? null,\n    diagnosePdfUrl: (d.diagnose_pdf_url as string | null) ?? null,\n    analyzePdfUrl: (d.analyze_pdf_url as string | null) ?? null,\n  };\n}\n\nexport function runListItemFromApi(d: Json): RunListItem {\n  return {\n    runId: String(d.run_id),\n    status: d.status as RunStatus,\n    creativeId: (d.creative_id as string | null) ?? null,\n    withAudio: Boolean(d.with_audio),\n    ready: Boolean(d.ready),\n    createdAt: String(d.created_at),\n  };\n}\n\nexport function accountFromApi(d: Json): Account {\n  return {\n    project: (d.project as string | null) ?? null,\n    balance: Number(d.balance),\n    quota: Number(d.quota),\n    used: Number(d.used ?? 0),\n    calibrated: Boolean(d.calibrated),\n  };\n}\n\nexport const isTerminal = (s: RunStatus): boolean => s === \"done\" || s === \"failed\";\n","import { RunFailedError, WaitTimeout, raiseForStatus } from \"./errors\";\nimport {\n  Account,\n  Run,\n  RunListItem,\n  accountFromApi,\n  runFromApi,\n  runListItemFromApi,\n} from \"./models\";\n\nexport const DEFAULT_BASE_URL = \"https://api.creacortex.ai\";\n\n/** A video to upload: a Blob/File, raw bytes, or (in Node) a file path. */\nexport type FileInput = Blob | Uint8Array | ArrayBuffer | string;\n\nexport interface ClientOptions {\n  baseUrl?: string;\n  timeoutMs?: number;\n  /** Inject a fetch implementation (tests, custom agents). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface UploadOptions {\n  filename?: string;\n  contentType?: string;\n}\n\nexport interface CreateRunOptions {\n  creativeId?: string;\n  withAudio?: boolean;\n  audience?: string;\n}\n\nexport interface WaitOptions {\n  intervalMs?: number;\n  timeoutMs?: number;\n}\n\nexport interface AnalyzeOptions extends CreateRunOptions, WaitOptions {\n  filename?: string;\n  /** Wait for the run to finish before resolving. Default: true. */\n  wait?: boolean;\n}\n\nconst sleep = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));\n\nasync function toBlob(file: FileInput, contentType: string): Promise<{ blob: Blob; name: string }> {\n  if (typeof file === \"string\") {\n    const { readFile } = await import(\"node:fs/promises\");\n    const { basename } = await import(\"node:path\");\n    const buf = await readFile(file);\n    return { blob: new Blob([buf], { type: contentType }), name: basename(file) };\n  }\n  if (file instanceof Blob) {\n    const named = file as Blob & { name?: string };\n    return { blob: file, name: named.name ?? \"video.mp4\" };\n  }\n  return { blob: new Blob([file], { type: contentType }), name: \"video.mp4\" };\n}\n\nexport class Creacortex {\n  private readonly key: string;\n  private readonly base: string;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(apiKey: string, opts: ClientOptions = {}) {\n    if (!apiKey) throw new Error(\"apiKey is required\");\n    this.key = apiKey;\n    this.base = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeoutMs = opts.timeoutMs ?? 60_000;\n    const f = opts.fetch ?? globalThis.fetch;\n    if (!f) throw new Error(\"global fetch is unavailable — pass options.fetch\");\n    this.fetchImpl = f;\n  }\n\n  private async req(path: string, init: RequestInit = {}): Promise<Response> {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);\n    try {\n      const headers = { \"X-API-Key\": this.key, ...(init.headers as Record<string, string>) };\n      return await this.fetchImpl(this.base + path, { ...init, headers, signal: ctrl.signal });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async json<T>(res: Response): Promise<T> {\n    await raiseForStatus(res);\n    return (await res.json()) as T;\n  }\n\n  private async bytes(res: Response): Promise<Uint8Array> {\n    await raiseForStatus(res);\n    return new Uint8Array(await res.arrayBuffer());\n  }\n\n  async uploadVideo(file: FileInput, opts: UploadOptions = {}): Promise<string> {\n    const { blob, name } = await toBlob(file, opts.contentType ?? \"video/mp4\");\n    const form = new FormData();\n    form.append(\"file\", blob, opts.filename ?? name);\n    const res = await this.req(\"/v1/videos\", { method: \"POST\", body: form });\n    return String((await this.json<{ video_id: string }>(res)).video_id);\n  }\n\n  async createRun(videoId: string, opts: CreateRunOptions = {}): Promise<Run> {\n    const body = JSON.stringify({\n      video_id: videoId,\n      creative_id: opts.creativeId ?? null,\n      with_audio: opts.withAudio ?? false,\n      audience: opts.audience ?? null,\n    });\n    const res = await this.req(\"/v1/runs\", {\n      method: \"POST\",\n      headers: { \"content-type\": \"application/json\" },\n      body,\n    });\n    return runFromApi(await this.json(res));\n  }\n\n  async getRun(runId: string): Promise<Run> {\n    return runFromApi(await this.json(await this.req(`/v1/runs/${runId}`)));\n  }\n\n  async listRuns(): Promise<RunListItem[]> {\n    const arr = await this.json<Record<string, unknown>[]>(await this.req(\"/v1/runs\"));\n    return arr.map(runListItemFromApi);\n  }\n\n  async getAccount(): Promise<Account> {\n    return accountFromApi(await this.json(await this.req(\"/v1/account\")));\n  }\n\n  private async calibForm(file: FileInput, filename: string): Promise<FormData> {\n    const { blob, name } = await toBlob(file, \"text/csv\");\n    const form = new FormData();\n    form.append(\"file\", blob, filename ?? name);\n    return form;\n  }\n\n  /** Step 1: detect columns and a guessed mapping for a performance CSV. */\n  async calibrationAnalyze(file: FileInput, filename = \"data.csv\"): Promise<unknown> {\n    const form = await this.calibForm(file, filename);\n    return this.json(await this.req(\"/v1/calibration/analyze\", { method: \"POST\", body: form }));\n  }\n\n  /** Step 2: summary (impression split, matched/processable, cost) — no charge. */\n  async calibrationPreview(\n    file: FileInput, mapping: Record<string, string>, minImpressions = 0, filename = \"data.csv\",\n  ): Promise<unknown> {\n    const form = await this.calibForm(file, filename);\n    form.append(\"mapping\", JSON.stringify(mapping));\n    form.append(\"min_impressions\", String(minImpressions));\n    return this.json(await this.req(\"/v1/calibration/preview\", { method: \"POST\", body: form }));\n  }\n\n  /** Step 3: charge, store actuals, fit calibration, queue unmatched videos. */\n  async calibrationCommit(\n    file: FileInput, mapping: Record<string, string>,\n    opts: { minImpressions?: number; processUnmatched?: boolean; filename?: string } = {},\n  ): Promise<unknown> {\n    const form = await this.calibForm(file, opts.filename ?? \"data.csv\");\n    form.append(\"mapping\", JSON.stringify(mapping));\n    form.append(\"min_impressions\", String(opts.minImpressions ?? 0));\n    form.append(\"process_unmatched\", String(opts.processUnmatched ?? false));\n    return this.json(await this.req(\"/v1/calibration/commit\", { method: \"POST\", body: form }));\n  }\n\n  /** Per-second analysis CSV (raw bytes). */\n  async getCsv(runId: string): Promise<Uint8Array> {\n    return this.bytes(await this.req(`/v1/runs/${runId}/data.csv`));\n  }\n\n  /** Gen-AI payload (parsed JSON). */\n  async getExport(runId: string): Promise<unknown> {\n    return this.json(await this.req(`/v1/runs/${runId}/export.json`));\n  }\n\n  /** PDF report bytes. kind is \"diagnose\" or \"analyze\". */\n  async getReport(runId: string, kind: \"diagnose\" | \"analyze\" = \"diagnose\"): Promise<Uint8Array> {\n    return this.bytes(await this.req(`/v1/runs/${runId}/report.pdf?kind=${encodeURIComponent(kind)}`));\n  }\n\n  /** Poll until the run reaches a terminal state. Rejects on failure/timeout. */\n  async wait(runId: string, opts: WaitOptions = {}): Promise<Run> {\n    const intervalMs = opts.intervalMs ?? 5_000;\n    const deadline = Date.now() + (opts.timeoutMs ?? 1_800_000);\n    for (;;) {\n      const run = await this.getRun(runId);\n      if (run.status === \"failed\") throw new RunFailedError(run.runId, run.error ?? undefined);\n      if (run.status === \"done\") return run;\n      if (Date.now() >= deadline) throw new WaitTimeout(`run ${runId} not done in time`);\n      await sleep(intervalMs);\n    }\n  }\n\n  /** Upload, start a run, and (by default) wait for it to finish. */\n  async analyze(file: FileInput, opts: AnalyzeOptions = {}): Promise<Run> {\n    const videoId = await this.uploadVideo(file, { filename: opts.filename });\n    const run = await this.createRun(videoId, opts);\n    if (opts.wait === false) return run;\n    return this.wait(run.runId, opts);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,WAAN,cAAuB,gBAAgB;AAAA,EACnC;AAAA,EAET,YAAY,QAAgB,SAAiB;AAC3C,UAAM,IAAI,MAAM,KAAK,OAAO,EAAE;AAC9B,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;AAGO,IAAM,YAAN,cAAwB,SAAS;AAAA,EACtC,YAAY,QAAgB,SAAiB;AAC3C,UAAM,QAAQ,OAAO;AACrB,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,2BAAN,cAAuC,SAAS;AAAA,EACrD,YAAY,QAAgB,SAAiB;AAC3C,UAAM,QAAQ,OAAO;AACrB,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,iBAAN,cAA6B,SAAS;AAAA,EAC3C,YAAY,QAAgB,SAAiB;AAC3C,UAAM,QAAQ,OAAO;AACrB,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,gBAAN,cAA4B,SAAS;AAAA,EAC1C,YAAY,QAAgB,SAAiB;AAC3C,UAAM,QAAQ,OAAO;AACrB,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,iBAAN,cAA6B,gBAAgB;AAAA,EACzC;AAAA,EACA;AAAA,EAET,YAAY,OAAe,OAAgB;AACzC,UAAM,OAAO,KAAK,YAAY,SAAS,eAAe,EAAE;AACxD,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,SAAK,QAAQ;AAAA,EACf;AACF;AAGO,IAAM,cAAN,cAA0B,gBAAgB;AAAA,EAC/C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEA,IAAM,YAAoE;AAAA,EACxE,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AACP;AAGA,eAAsB,eAAe,KAA8B;AACjE,MAAI,IAAI,GAAI;AACZ,QAAM,SAAS,MAAM,WAAW,GAAG;AACnC,QAAM,MAAM,UAAU,IAAI,MAAM,KAAK;AACrC,QAAM,IAAI,IAAI,IAAI,QAAQ,MAAM;AAClC;AAEA,eAAe,WAAW,KAAgC;AACxD,QAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,MAAI;AACF,UAAM,OAAO,KAAK,MAAM,IAAI;AAC5B,QAAI,QAAQ,OAAO,SAAS,YAAY,YAAY,KAAM,QAAO,OAAO,KAAK,MAAM;AACnF,WAAO;AAAA,EACT,QAAQ;AACN,WAAO,QAAQ,IAAI;AAAA,EACrB;AACF;;;AC7DO,SAAS,WAAW,GAAc;AACvC,SAAO;AAAA,IACL,OAAO,OAAO,EAAE,MAAM;AAAA,IACtB,QAAQ,EAAE;AAAA,IACV,YAAa,EAAE,eAAiC;AAAA,IAChD,WAAW,QAAQ,EAAE,UAAU;AAAA,IAC/B,OAAQ,EAAE,SAA2B;AAAA,IACrC,OAAO,QAAQ,EAAE,KAAK;AAAA,IACtB,QAAS,EAAE,WAA6B;AAAA,IACxC,WAAY,EAAE,cAAgC;AAAA,IAC9C,gBAAiB,EAAE,oBAAsC;AAAA,IACzD,eAAgB,EAAE,mBAAqC;AAAA,EACzD;AACF;AAEO,SAAS,mBAAmB,GAAsB;AACvD,SAAO;AAAA,IACL,OAAO,OAAO,EAAE,MAAM;AAAA,IACtB,QAAQ,EAAE;AAAA,IACV,YAAa,EAAE,eAAiC;AAAA,IAChD,WAAW,QAAQ,EAAE,UAAU;AAAA,IAC/B,OAAO,QAAQ,EAAE,KAAK;AAAA,IACtB,WAAW,OAAO,EAAE,UAAU;AAAA,EAChC;AACF;AAEO,SAAS,eAAe,GAAkB;AAC/C,SAAO;AAAA,IACL,SAAU,EAAE,WAA6B;AAAA,IACzC,SAAS,OAAO,EAAE,OAAO;AAAA,IACzB,OAAO,OAAO,EAAE,KAAK;AAAA,IACrB,MAAM,OAAO,EAAE,QAAQ,CAAC;AAAA,IACxB,YAAY,QAAQ,EAAE,UAAU;AAAA,EAClC;AACF;;;AC5DO,IAAM,mBAAmB;AAkChC,IAAM,QAAQ,CAAC,OAA8B,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAEjF,eAAe,OAAO,MAAiB,aAA4D;AACjG,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,EAAE,SAAS,IAAI,MAAM,OAAO,aAAkB;AACpD,UAAM,EAAE,SAAS,IAAI,MAAM,OAAO,MAAW;AAC7C,UAAM,MAAM,MAAM,SAAS,IAAI;AAC/B,WAAO,EAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,EAAE,MAAM,YAAY,CAAC,GAAG,MAAM,SAAS,IAAI,EAAE;AAAA,EAC9E;AACA,MAAI,gBAAgB,MAAM;AACxB,UAAM,QAAQ;AACd,WAAO,EAAE,MAAM,MAAM,MAAM,MAAM,QAAQ,YAAY;AAAA,EACvD;AACA,SAAO,EAAE,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,MAAM,YAAY,CAAC,GAAG,MAAM,YAAY;AAC5E;AAEO,IAAM,aAAN,MAAiB;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,QAAgB,OAAsB,CAAC,GAAG;AACpD,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,oBAAoB;AACjD,SAAK,MAAM;AACX,SAAK,QAAQ,KAAK,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AACjE,SAAK,YAAY,KAAK,aAAa;AACnC,UAAM,IAAI,KAAK,SAAS,WAAW;AACnC,QAAI,CAAC,EAAG,OAAM,IAAI,MAAM,uDAAkD;AAC1E,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,MAAc,IAAI,MAAc,OAAoB,CAAC,GAAsB;AACzE,UAAM,OAAO,IAAI,gBAAgB;AACjC,UAAM,QAAQ,WAAW,MAAM,KAAK,MAAM,GAAG,KAAK,SAAS;AAC3D,QAAI;AACF,YAAM,UAAU,EAAE,aAAa,KAAK,KAAK,GAAI,KAAK,QAAmC;AACrF,aAAO,MAAM,KAAK,UAAU,KAAK,OAAO,MAAM,EAAE,GAAG,MAAM,SAAS,QAAQ,KAAK,OAAO,CAAC;AAAA,IACzF,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,MAAc,KAAQ,KAA2B;AAC/C,UAAM,eAAe,GAAG;AACxB,WAAQ,MAAM,IAAI,KAAK;AAAA,EACzB;AAAA,EAEA,MAAc,MAAM,KAAoC;AACtD,UAAM,eAAe,GAAG;AACxB,WAAO,IAAI,WAAW,MAAM,IAAI,YAAY,CAAC;AAAA,EAC/C;AAAA,EAEA,MAAM,YAAY,MAAiB,OAAsB,CAAC,GAAoB;AAC5E,UAAM,EAAE,MAAM,KAAK,IAAI,MAAM,OAAO,MAAM,KAAK,eAAe,WAAW;AACzE,UAAM,OAAO,IAAI,SAAS;AAC1B,SAAK,OAAO,QAAQ,MAAM,KAAK,YAAY,IAAI;AAC/C,UAAM,MAAM,MAAM,KAAK,IAAI,cAAc,EAAE,QAAQ,QAAQ,MAAM,KAAK,CAAC;AACvE,WAAO,QAAQ,MAAM,KAAK,KAA2B,GAAG,GAAG,QAAQ;AAAA,EACrE;AAAA,EAEA,MAAM,UAAU,SAAiB,OAAyB,CAAC,GAAiB;AAC1E,UAAM,OAAO,KAAK,UAAU;AAAA,MAC1B,UAAU;AAAA,MACV,aAAa,KAAK,cAAc;AAAA,MAChC,YAAY,KAAK,aAAa;AAAA,MAC9B,UAAU,KAAK,YAAY;AAAA,IAC7B,CAAC;AACD,UAAM,MAAM,MAAM,KAAK,IAAI,YAAY;AAAA,MACrC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C;AAAA,IACF,CAAC;AACD,WAAO,WAAW,MAAM,KAAK,KAAK,GAAG,CAAC;AAAA,EACxC;AAAA,EAEA,MAAM,OAAO,OAA6B;AACxC,WAAO,WAAW,MAAM,KAAK,KAAK,MAAM,KAAK,IAAI,YAAY,KAAK,EAAE,CAAC,CAAC;AAAA,EACxE;AAAA,EAEA,MAAM,WAAmC;AACvC,UAAM,MAAM,MAAM,KAAK,KAAgC,MAAM,KAAK,IAAI,UAAU,CAAC;AACjF,WAAO,IAAI,IAAI,kBAAkB;AAAA,EACnC;AAAA,EAEA,MAAM,aAA+B;AACnC,WAAO,eAAe,MAAM,KAAK,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,CAAC;AAAA,EACtE;AAAA,EAEA,MAAc,UAAU,MAAiB,UAAqC;AAC5E,UAAM,EAAE,MAAM,KAAK,IAAI,MAAM,OAAO,MAAM,UAAU;AACpD,UAAM,OAAO,IAAI,SAAS;AAC1B,SAAK,OAAO,QAAQ,MAAM,YAAY,IAAI;AAC1C,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,mBAAmB,MAAiB,WAAW,YAA8B;AACjF,UAAM,OAAO,MAAM,KAAK,UAAU,MAAM,QAAQ;AAChD,WAAO,KAAK,KAAK,MAAM,KAAK,IAAI,2BAA2B,EAAE,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC;AAAA,EAC5F;AAAA;AAAA,EAGA,MAAM,mBACJ,MAAiB,SAAiC,iBAAiB,GAAG,WAAW,YAC/D;AAClB,UAAM,OAAO,MAAM,KAAK,UAAU,MAAM,QAAQ;AAChD,SAAK,OAAO,WAAW,KAAK,UAAU,OAAO,CAAC;AAC9C,SAAK,OAAO,mBAAmB,OAAO,cAAc,CAAC;AACrD,WAAO,KAAK,KAAK,MAAM,KAAK,IAAI,2BAA2B,EAAE,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC;AAAA,EAC5F;AAAA;AAAA,EAGA,MAAM,kBACJ,MAAiB,SACjB,OAAmF,CAAC,GAClE;AAClB,UAAM,OAAO,MAAM,KAAK,UAAU,MAAM,KAAK,YAAY,UAAU;AACnE,SAAK,OAAO,WAAW,KAAK,UAAU,OAAO,CAAC;AAC9C,SAAK,OAAO,mBAAmB,OAAO,KAAK,kBAAkB,CAAC,CAAC;AAC/D,SAAK,OAAO,qBAAqB,OAAO,KAAK,oBAAoB,KAAK,CAAC;AACvE,WAAO,KAAK,KAAK,MAAM,KAAK,IAAI,0BAA0B,EAAE,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC;AAAA,EAC3F;AAAA;AAAA,EAGA,MAAM,OAAO,OAAoC;AAC/C,WAAO,KAAK,MAAM,MAAM,KAAK,IAAI,YAAY,KAAK,WAAW,CAAC;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,UAAU,OAAiC;AAC/C,WAAO,KAAK,KAAK,MAAM,KAAK,IAAI,YAAY,KAAK,cAAc,CAAC;AAAA,EAClE;AAAA;AAAA,EAGA,MAAM,UAAU,OAAe,OAA+B,YAAiC;AAC7F,WAAO,KAAK,MAAM,MAAM,KAAK,IAAI,YAAY,KAAK,oBAAoB,mBAAmB,IAAI,CAAC,EAAE,CAAC;AAAA,EACnG;AAAA;AAAA,EAGA,MAAM,KAAK,OAAe,OAAoB,CAAC,GAAiB;AAC9D,UAAM,aAAa,KAAK,cAAc;AACtC,UAAM,WAAW,KAAK,IAAI,KAAK,KAAK,aAAa;AACjD,eAAS;AACP,YAAM,MAAM,MAAM,KAAK,OAAO,KAAK;AACnC,UAAI,IAAI,WAAW,SAAU,OAAM,IAAI,eAAe,IAAI,OAAO,IAAI,SAAS,MAAS;AACvF,UAAI,IAAI,WAAW,OAAQ,QAAO;AAClC,UAAI,KAAK,IAAI,KAAK,SAAU,OAAM,IAAI,YAAY,OAAO,KAAK,mBAAmB;AACjF,YAAM,MAAM,UAAU;AAAA,IACxB;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,QAAQ,MAAiB,OAAuB,CAAC,GAAiB;AACtE,UAAM,UAAU,MAAM,KAAK,YAAY,MAAM,EAAE,UAAU,KAAK,SAAS,CAAC;AACxE,UAAM,MAAM,MAAM,KAAK,UAAU,SAAS,IAAI;AAC9C,QAAI,KAAK,SAAS,MAAO,QAAO;AAChC,WAAO,KAAK,KAAK,IAAI,OAAO,IAAI;AAAA,EAClC;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,131 @@
+/** Typed response models (camelCase), mapped from the API's snake_case JSON. */
+type RunStatus = "queued" | "running" | "done" | "failed";
+interface Run {
+    runId: string;
+    status: RunStatus;
+    creativeId?: string | null;
+    withAudio: boolean;
+    error?: string | null;
+    ready: boolean;
+    csvUrl?: string | null;
+    exportUrl?: string | null;
+    diagnosePdfUrl?: string | null;
+    analyzePdfUrl?: string | null;
+}
+interface RunListItem {
+    runId: string;
+    status: RunStatus;
+    creativeId?: string | null;
+    withAudio: boolean;
+    ready: boolean;
+    createdAt: string;
+}
+interface Account {
+    project?: string | null;
+    balance: number;
+    quota: number;
+    used: number;
+    calibrated: boolean;
+}
+
+declare const DEFAULT_BASE_URL = "https://api.creacortex.ai";
+/** A video to upload: a Blob/File, raw bytes, or (in Node) a file path. */
+type FileInput = Blob | Uint8Array | ArrayBuffer | string;
+interface ClientOptions {
+    baseUrl?: string;
+    timeoutMs?: number;
+    /** Inject a fetch implementation (tests, custom agents). Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+interface UploadOptions {
+    filename?: string;
+    contentType?: string;
+}
+interface CreateRunOptions {
+    creativeId?: string;
+    withAudio?: boolean;
+    audience?: string;
+}
+interface WaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+}
+interface AnalyzeOptions extends CreateRunOptions, WaitOptions {
+    filename?: string;
+    /** Wait for the run to finish before resolving. Default: true. */
+    wait?: boolean;
+}
+declare class Creacortex {
+    private readonly key;
+    private readonly base;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(apiKey: string, opts?: ClientOptions);
+    private req;
+    private json;
+    private bytes;
+    uploadVideo(file: FileInput, opts?: UploadOptions): Promise<string>;
+    createRun(videoId: string, opts?: CreateRunOptions): Promise<Run>;
+    getRun(runId: string): Promise<Run>;
+    listRuns(): Promise<RunListItem[]>;
+    getAccount(): Promise<Account>;
+    private calibForm;
+    /** Step 1: detect columns and a guessed mapping for a performance CSV. */
+    calibrationAnalyze(file: FileInput, filename?: string): Promise<unknown>;
+    /** Step 2: summary (impression split, matched/processable, cost) — no charge. */
+    calibrationPreview(file: FileInput, mapping: Record<string, string>, minImpressions?: number, filename?: string): Promise<unknown>;
+    /** Step 3: charge, store actuals, fit calibration, queue unmatched videos. */
+    calibrationCommit(file: FileInput, mapping: Record<string, string>, opts?: {
+        minImpressions?: number;
+        processUnmatched?: boolean;
+        filename?: string;
+    }): Promise<unknown>;
+    /** Per-second analysis CSV (raw bytes). */
+    getCsv(runId: string): Promise<Uint8Array>;
+    /** Gen-AI payload (parsed JSON). */
+    getExport(runId: string): Promise<unknown>;
+    /** PDF report bytes. kind is "diagnose" or "analyze". */
+    getReport(runId: string, kind?: "diagnose" | "analyze"): Promise<Uint8Array>;
+    /** Poll until the run reaches a terminal state. Rejects on failure/timeout. */
+    wait(runId: string, opts?: WaitOptions): Promise<Run>;
+    /** Upload, start a run, and (by default) wait for it to finish. */
+    analyze(file: FileInput, opts?: AnalyzeOptions): Promise<Run>;
+}
+
+/** Errors thrown by the Creacortex client. */
+declare class CreacortexError extends Error {
+    constructor(message: string);
+}
+/** An HTTP error returned by the API (status >= 400). */
+declare class ApiError extends CreacortexError {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/** Invalid or missing API key (401). */
+declare class AuthError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** Not enough credits to run the analysis (402). */
+declare class InsufficientCreditsError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** Too many requests (429). */
+declare class RateLimitError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** Unknown run or resource (404). */
+declare class NotFoundError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** The run finished with status="failed". */
+declare class RunFailedError extends CreacortexError {
+    readonly runId: string;
+    readonly cause?: string;
+    constructor(runId: string, cause?: string);
+}
+/** A run did not finish within the wait timeout. */
+declare class WaitTimeout extends CreacortexError {
+    constructor(message: string);
+}
+
+export { type Account, type AnalyzeOptions, ApiError, AuthError, type ClientOptions, Creacortex, CreacortexError, type CreateRunOptions, DEFAULT_BASE_URL, type FileInput, InsufficientCreditsError, NotFoundError, RateLimitError, type Run, RunFailedError, type RunListItem, type RunStatus, type UploadOptions, type WaitOptions, WaitTimeout };

package/dist/index.d.ts

@@ -0,0 +1,131 @@
+/** Typed response models (camelCase), mapped from the API's snake_case JSON. */
+type RunStatus = "queued" | "running" | "done" | "failed";
+interface Run {
+    runId: string;
+    status: RunStatus;
+    creativeId?: string | null;
+    withAudio: boolean;
+    error?: string | null;
+    ready: boolean;
+    csvUrl?: string | null;
+    exportUrl?: string | null;
+    diagnosePdfUrl?: string | null;
+    analyzePdfUrl?: string | null;
+}
+interface RunListItem {
+    runId: string;
+    status: RunStatus;
+    creativeId?: string | null;
+    withAudio: boolean;
+    ready: boolean;
+    createdAt: string;
+}
+interface Account {
+    project?: string | null;
+    balance: number;
+    quota: number;
+    used: number;
+    calibrated: boolean;
+}
+
+declare const DEFAULT_BASE_URL = "https://api.creacortex.ai";
+/** A video to upload: a Blob/File, raw bytes, or (in Node) a file path. */
+type FileInput = Blob | Uint8Array | ArrayBuffer | string;
+interface ClientOptions {
+    baseUrl?: string;
+    timeoutMs?: number;
+    /** Inject a fetch implementation (tests, custom agents). Defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+interface UploadOptions {
+    filename?: string;
+    contentType?: string;
+}
+interface CreateRunOptions {
+    creativeId?: string;
+    withAudio?: boolean;
+    audience?: string;
+}
+interface WaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+}
+interface AnalyzeOptions extends CreateRunOptions, WaitOptions {
+    filename?: string;
+    /** Wait for the run to finish before resolving. Default: true. */
+    wait?: boolean;
+}
+declare class Creacortex {
+    private readonly key;
+    private readonly base;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(apiKey: string, opts?: ClientOptions);
+    private req;
+    private json;
+    private bytes;
+    uploadVideo(file: FileInput, opts?: UploadOptions): Promise<string>;
+    createRun(videoId: string, opts?: CreateRunOptions): Promise<Run>;
+    getRun(runId: string): Promise<Run>;
+    listRuns(): Promise<RunListItem[]>;
+    getAccount(): Promise<Account>;
+    private calibForm;
+    /** Step 1: detect columns and a guessed mapping for a performance CSV. */
+    calibrationAnalyze(file: FileInput, filename?: string): Promise<unknown>;
+    /** Step 2: summary (impression split, matched/processable, cost) — no charge. */
+    calibrationPreview(file: FileInput, mapping: Record<string, string>, minImpressions?: number, filename?: string): Promise<unknown>;
+    /** Step 3: charge, store actuals, fit calibration, queue unmatched videos. */
+    calibrationCommit(file: FileInput, mapping: Record<string, string>, opts?: {
+        minImpressions?: number;
+        processUnmatched?: boolean;
+        filename?: string;
+    }): Promise<unknown>;
+    /** Per-second analysis CSV (raw bytes). */
+    getCsv(runId: string): Promise<Uint8Array>;
+    /** Gen-AI payload (parsed JSON). */
+    getExport(runId: string): Promise<unknown>;
+    /** PDF report bytes. kind is "diagnose" or "analyze". */
+    getReport(runId: string, kind?: "diagnose" | "analyze"): Promise<Uint8Array>;
+    /** Poll until the run reaches a terminal state. Rejects on failure/timeout. */
+    wait(runId: string, opts?: WaitOptions): Promise<Run>;
+    /** Upload, start a run, and (by default) wait for it to finish. */
+    analyze(file: FileInput, opts?: AnalyzeOptions): Promise<Run>;
+}
+
+/** Errors thrown by the Creacortex client. */
+declare class CreacortexError extends Error {
+    constructor(message: string);
+}
+/** An HTTP error returned by the API (status >= 400). */
+declare class ApiError extends CreacortexError {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/** Invalid or missing API key (401). */
+declare class AuthError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** Not enough credits to run the analysis (402). */
+declare class InsufficientCreditsError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** Too many requests (429). */
+declare class RateLimitError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** Unknown run or resource (404). */
+declare class NotFoundError extends ApiError {
+    constructor(status: number, message: string);
+}
+/** The run finished with status="failed". */
+declare class RunFailedError extends CreacortexError {
+    readonly runId: string;
+    readonly cause?: string;
+    constructor(runId: string, cause?: string);
+}
+/** A run did not finish within the wait timeout. */
+declare class WaitTimeout extends CreacortexError {
+    constructor(message: string);
+}
+
+export { type Account, type AnalyzeOptions, ApiError, AuthError, type ClientOptions, Creacortex, CreacortexError, type CreateRunOptions, DEFAULT_BASE_URL, type FileInput, InsufficientCreditsError, NotFoundError, RateLimitError, type Run, RunFailedError, type RunListItem, type RunStatus, type UploadOptions, type WaitOptions, WaitTimeout };

package/dist/index.js

@@ -0,0 +1,263 @@
+// src/errors.ts
+var CreacortexError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CreacortexError";
+  }
+};
+var ApiError = class extends CreacortexError {
+  status;
+  constructor(status, message) {
+    super(`[${status}] ${message}`);
+    this.name = "ApiError";
+    this.status = status;
+  }
+};
+var AuthError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "AuthError";
+  }
+};
+var InsufficientCreditsError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "InsufficientCreditsError";
+  }
+};
+var RateLimitError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "RateLimitError";
+  }
+};
+var NotFoundError = class extends ApiError {
+  constructor(status, message) {
+    super(status, message);
+    this.name = "NotFoundError";
+  }
+};
+var RunFailedError = class extends CreacortexError {
+  runId;
+  cause;
+  constructor(runId, cause) {
+    super(`run ${runId} failed: ${cause ?? "unknown error"}`);
+    this.name = "RunFailedError";
+    this.runId = runId;
+    this.cause = cause;
+  }
+};
+var WaitTimeout = class extends CreacortexError {
+  constructor(message) {
+    super(message);
+    this.name = "WaitTimeout";
+  }
+};
+var BY_STATUS = {
+  401: AuthError,
+  402: InsufficientCreditsError,
+  404: NotFoundError,
+  429: RateLimitError
+};
+async function raiseForStatus(res) {
+  if (res.ok) return;
+  const detail = await readDetail(res);
+  const Cls = BY_STATUS[res.status] ?? ApiError;
+  throw new Cls(res.status, detail);
+}
+async function readDetail(res) {
+  const text = await res.text();
+  try {
+    const body = JSON.parse(text);
+    if (body && typeof body === "object" && "detail" in body) return String(body.detail);
+    return text;
+  } catch {
+    return text || res.statusText;
+  }
+}
+
+// src/models.ts
+function runFromApi(d) {
+  return {
+    runId: String(d.run_id),
+    status: d.status,
+    creativeId: d.creative_id ?? null,
+    withAudio: Boolean(d.with_audio),
+    error: d.error ?? null,
+    ready: Boolean(d.ready),
+    csvUrl: d.csv_url ?? null,
+    exportUrl: d.export_url ?? null,
+    diagnosePdfUrl: d.diagnose_pdf_url ?? null,
+    analyzePdfUrl: d.analyze_pdf_url ?? null
+  };
+}
+function runListItemFromApi(d) {
+  return {
+    runId: String(d.run_id),
+    status: d.status,
+    creativeId: d.creative_id ?? null,
+    withAudio: Boolean(d.with_audio),
+    ready: Boolean(d.ready),
+    createdAt: String(d.created_at)
+  };
+}
+function accountFromApi(d) {
+  return {
+    project: d.project ?? null,
+    balance: Number(d.balance),
+    quota: Number(d.quota),
+    used: Number(d.used ?? 0),
+    calibrated: Boolean(d.calibrated)
+  };
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.creacortex.ai";
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function toBlob(file, contentType) {
+  if (typeof file === "string") {
+    const { readFile } = await import("fs/promises");
+    const { basename } = await import("path");
+    const buf = await readFile(file);
+    return { blob: new Blob([buf], { type: contentType }), name: basename(file) };
+  }
+  if (file instanceof Blob) {
+    const named = file;
+    return { blob: file, name: named.name ?? "video.mp4" };
+  }
+  return { blob: new Blob([file], { type: contentType }), name: "video.mp4" };
+}
+var Creacortex = class {
+  key;
+  base;
+  timeoutMs;
+  fetchImpl;
+  constructor(apiKey, opts = {}) {
+    if (!apiKey) throw new Error("apiKey is required");
+    this.key = apiKey;
+    this.base = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeoutMs = opts.timeoutMs ?? 6e4;
+    const f = opts.fetch ?? globalThis.fetch;
+    if (!f) throw new Error("global fetch is unavailable \u2014 pass options.fetch");
+    this.fetchImpl = f;
+  }
+  async req(path, init = {}) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    try {
+      const headers = { "X-API-Key": this.key, ...init.headers };
+      return await this.fetchImpl(this.base + path, { ...init, headers, signal: ctrl.signal });
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async json(res) {
+    await raiseForStatus(res);
+    return await res.json();
+  }
+  async bytes(res) {
+    await raiseForStatus(res);
+    return new Uint8Array(await res.arrayBuffer());
+  }
+  async uploadVideo(file, opts = {}) {
+    const { blob, name } = await toBlob(file, opts.contentType ?? "video/mp4");
+    const form = new FormData();
+    form.append("file", blob, opts.filename ?? name);
+    const res = await this.req("/v1/videos", { method: "POST", body: form });
+    return String((await this.json(res)).video_id);
+  }
+  async createRun(videoId, opts = {}) {
+    const body = JSON.stringify({
+      video_id: videoId,
+      creative_id: opts.creativeId ?? null,
+      with_audio: opts.withAudio ?? false,
+      audience: opts.audience ?? null
+    });
+    const res = await this.req("/v1/runs", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body
+    });
+    return runFromApi(await this.json(res));
+  }
+  async getRun(runId) {
+    return runFromApi(await this.json(await this.req(`/v1/runs/${runId}`)));
+  }
+  async listRuns() {
+    const arr = await this.json(await this.req("/v1/runs"));
+    return arr.map(runListItemFromApi);
+  }
+  async getAccount() {
+    return accountFromApi(await this.json(await this.req("/v1/account")));
+  }
+  async calibForm(file, filename) {
+    const { blob, name } = await toBlob(file, "text/csv");
+    const form = new FormData();
+    form.append("file", blob, filename ?? name);
+    return form;
+  }
+  /** Step 1: detect columns and a guessed mapping for a performance CSV. */
+  async calibrationAnalyze(file, filename = "data.csv") {
+    const form = await this.calibForm(file, filename);
+    return this.json(await this.req("/v1/calibration/analyze", { method: "POST", body: form }));
+  }
+  /** Step 2: summary (impression split, matched/processable, cost) — no charge. */
+  async calibrationPreview(file, mapping, minImpressions = 0, filename = "data.csv") {
+    const form = await this.calibForm(file, filename);
+    form.append("mapping", JSON.stringify(mapping));
+    form.append("min_impressions", String(minImpressions));
+    return this.json(await this.req("/v1/calibration/preview", { method: "POST", body: form }));
+  }
+  /** Step 3: charge, store actuals, fit calibration, queue unmatched videos. */
+  async calibrationCommit(file, mapping, opts = {}) {
+    const form = await this.calibForm(file, opts.filename ?? "data.csv");
+    form.append("mapping", JSON.stringify(mapping));
+    form.append("min_impressions", String(opts.minImpressions ?? 0));
+    form.append("process_unmatched", String(opts.processUnmatched ?? false));
+    return this.json(await this.req("/v1/calibration/commit", { method: "POST", body: form }));
+  }
+  /** Per-second analysis CSV (raw bytes). */
+  async getCsv(runId) {
+    return this.bytes(await this.req(`/v1/runs/${runId}/data.csv`));
+  }
+  /** Gen-AI payload (parsed JSON). */
+  async getExport(runId) {
+    return this.json(await this.req(`/v1/runs/${runId}/export.json`));
+  }
+  /** PDF report bytes. kind is "diagnose" or "analyze". */
+  async getReport(runId, kind = "diagnose") {
+    return this.bytes(await this.req(`/v1/runs/${runId}/report.pdf?kind=${encodeURIComponent(kind)}`));
+  }
+  /** Poll until the run reaches a terminal state. Rejects on failure/timeout. */
+  async wait(runId, opts = {}) {
+    const intervalMs = opts.intervalMs ?? 5e3;
+    const deadline = Date.now() + (opts.timeoutMs ?? 18e5);
+    for (; ; ) {
+      const run = await this.getRun(runId);
+      if (run.status === "failed") throw new RunFailedError(run.runId, run.error ?? void 0);
+      if (run.status === "done") return run;
+      if (Date.now() >= deadline) throw new WaitTimeout(`run ${runId} not done in time`);
+      await sleep(intervalMs);
+    }
+  }
+  /** Upload, start a run, and (by default) wait for it to finish. */
+  async analyze(file, opts = {}) {
+    const videoId = await this.uploadVideo(file, { filename: opts.filename });
+    const run = await this.createRun(videoId, opts);
+    if (opts.wait === false) return run;
+    return this.wait(run.runId, opts);
+  }
+};
+export {
+  ApiError,
+  AuthError,
+  Creacortex,
+  CreacortexError,
+  DEFAULT_BASE_URL,
+  InsufficientCreditsError,
+  NotFoundError,
+  RateLimitError,
+  RunFailedError,
+  WaitTimeout
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/models.ts","../src/client.ts"],"sourcesContent":["/** Errors thrown by the Creacortex client. */\n\nexport class CreacortexError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CreacortexError\";\n  }\n}\n\n/** An HTTP error returned by the API (status >= 400). */\nexport class ApiError extends CreacortexError {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(`[${status}] ${message}`);\n    this.name = \"ApiError\";\n    this.status = status;\n  }\n}\n\n/** Invalid or missing API key (401). */\nexport class AuthError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"AuthError\";\n  }\n}\n\n/** Not enough credits to run the analysis (402). */\nexport class InsufficientCreditsError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"InsufficientCreditsError\";\n  }\n}\n\n/** Too many requests (429). */\nexport class RateLimitError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"RateLimitError\";\n  }\n}\n\n/** Unknown run or resource (404). */\nexport class NotFoundError extends ApiError {\n  constructor(status: number, message: string) {\n    super(status, message);\n    this.name = \"NotFoundError\";\n  }\n}\n\n/** The run finished with status=\"failed\". */\nexport class RunFailedError extends CreacortexError {\n  readonly runId: string;\n  readonly cause?: string;\n\n  constructor(runId: string, cause?: string) {\n    super(`run ${runId} failed: ${cause ?? \"unknown error\"}`);\n    this.name = \"RunFailedError\";\n    this.runId = runId;\n    this.cause = cause;\n  }\n}\n\n/** A run did not finish within the wait timeout. */\nexport class WaitTimeout extends CreacortexError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"WaitTimeout\";\n  }\n}\n\nconst BY_STATUS: Record<number, new (s: number, m: string) => ApiError> = {\n  401: AuthError,\n  402: InsufficientCreditsError,\n  404: NotFoundError,\n  429: RateLimitError,\n};\n\n/** Throw the appropriate typed error for a non-OK response. */\nexport async function raiseForStatus(res: Response): Promise<void> {\n  if (res.ok) return;\n  const detail = await readDetail(res);\n  const Cls = BY_STATUS[res.status] ?? ApiError;\n  throw new Cls(res.status, detail);\n}\n\nasync function readDetail(res: Response): Promise<string> {\n  const text = await res.text();\n  try {\n    const body = JSON.parse(text);\n    if (body && typeof body === \"object\" && \"detail\" in body) return String(body.detail);\n    return text;\n  } catch {\n    return text || res.statusText;\n  }\n}\n","/** Typed response models (camelCase), mapped from the API's snake_case JSON. */\n\nexport type RunStatus = \"queued\" | \"running\" | \"done\" | \"failed\";\n\nexport interface Run {\n  runId: string;\n  status: RunStatus;\n  creativeId?: string | null;\n  withAudio: boolean;\n  error?: string | null;\n  ready: boolean;\n  csvUrl?: string | null;\n  exportUrl?: string | null;\n  diagnosePdfUrl?: string | null;\n  analyzePdfUrl?: string | null;\n}\n\nexport interface RunListItem {\n  runId: string;\n  status: RunStatus;\n  creativeId?: string | null;\n  withAudio: boolean;\n  ready: boolean;\n  createdAt: string;\n}\n\nexport interface Account {\n  project?: string | null;\n  balance: number;\n  quota: number;\n  used: number;\n  calibrated: boolean;\n}\n\ntype Json = Record<string, unknown>;\n\nexport function runFromApi(d: Json): Run {\n  return {\n    runId: String(d.run_id),\n    status: d.status as RunStatus,\n    creativeId: (d.creative_id as string | null) ?? null,\n    withAudio: Boolean(d.with_audio),\n    error: (d.error as string | null) ?? null,\n    ready: Boolean(d.ready),\n    csvUrl: (d.csv_url as string | null) ?? null,\n    exportUrl: (d.export_url as string | null) ?? null,\n    diagnosePdfUrl: (d.diagnose_pdf_url as string | null) ?? null,\n    analyzePdfUrl: (d.analyze_pdf_url as string | null) ?? null,\n  };\n}\n\nexport function runListItemFromApi(d: Json): RunListItem {\n  return {\n    runId: String(d.run_id),\n    status: d.status as RunStatus,\n    creativeId: (d.creative_id as string | null) ?? null,\n    withAudio: Boolean(d.with_audio),\n    ready: Boolean(d.ready),\n    createdAt: String(d.created_at),\n  };\n}\n\nexport function accountFromApi(d: Json): Account {\n  return {\n    project: (d.project as string | null) ?? null,\n    balance: Number(d.balance),\n    quota: Number(d.quota),\n    used: Number(d.used ?? 0),\n    calibrated: Boolean(d.calibrated),\n  };\n}\n\nexport const isTerminal = (s: RunStatus): boolean => s === \"done\" || s === \"failed\";\n","import { RunFailedError, WaitTimeout, raiseForStatus } from \"./errors\";\nimport {\n  Account,\n  Run,\n  RunListItem,\n  accountFromApi,\n  runFromApi,\n  runListItemFromApi,\n} from \"./models\";\n\nexport const DEFAULT_BASE_URL = \"https://api.creacortex.ai\";\n\n/** A video to upload: a Blob/File, raw bytes, or (in Node) a file path. */\nexport type FileInput = Blob | Uint8Array | ArrayBuffer | string;\n\nexport interface ClientOptions {\n  baseUrl?: string;\n  timeoutMs?: number;\n  /** Inject a fetch implementation (tests, custom agents). Defaults to global fetch. */\n  fetch?: typeof fetch;\n}\n\nexport interface UploadOptions {\n  filename?: string;\n  contentType?: string;\n}\n\nexport interface CreateRunOptions {\n  creativeId?: string;\n  withAudio?: boolean;\n  audience?: string;\n}\n\nexport interface WaitOptions {\n  intervalMs?: number;\n  timeoutMs?: number;\n}\n\nexport interface AnalyzeOptions extends CreateRunOptions, WaitOptions {\n  filename?: string;\n  /** Wait for the run to finish before resolving. Default: true. */\n  wait?: boolean;\n}\n\nconst sleep = (ms: number): Promise<void> => new Promise((r) => setTimeout(r, ms));\n\nasync function toBlob(file: FileInput, contentType: string): Promise<{ blob: Blob; name: string }> {\n  if (typeof file === \"string\") {\n    const { readFile } = await import(\"node:fs/promises\");\n    const { basename } = await import(\"node:path\");\n    const buf = await readFile(file);\n    return { blob: new Blob([buf], { type: contentType }), name: basename(file) };\n  }\n  if (file instanceof Blob) {\n    const named = file as Blob & { name?: string };\n    return { blob: file, name: named.name ?? \"video.mp4\" };\n  }\n  return { blob: new Blob([file], { type: contentType }), name: \"video.mp4\" };\n}\n\nexport class Creacortex {\n  private readonly key: string;\n  private readonly base: string;\n  private readonly timeoutMs: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(apiKey: string, opts: ClientOptions = {}) {\n    if (!apiKey) throw new Error(\"apiKey is required\");\n    this.key = apiKey;\n    this.base = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeoutMs = opts.timeoutMs ?? 60_000;\n    const f = opts.fetch ?? globalThis.fetch;\n    if (!f) throw new Error(\"global fetch is unavailable — pass options.fetch\");\n    this.fetchImpl = f;\n  }\n\n  private async req(path: string, init: RequestInit = {}): Promise<Response> {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);\n    try {\n      const headers = { \"X-API-Key\": this.key, ...(init.headers as Record<string, string>) };\n      return await this.fetchImpl(this.base + path, { ...init, headers, signal: ctrl.signal });\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async json<T>(res: Response): Promise<T> {\n    await raiseForStatus(res);\n    return (await res.json()) as T;\n  }\n\n  private async bytes(res: Response): Promise<Uint8Array> {\n    await raiseForStatus(res);\n    return new Uint8Array(await res.arrayBuffer());\n  }\n\n  async uploadVideo(file: FileInput, opts: UploadOptions = {}): Promise<string> {\n    const { blob, name } = await toBlob(file, opts.contentType ?? \"video/mp4\");\n    const form = new FormData();\n    form.append(\"file\", blob, opts.filename ?? name);\n    const res = await this.req(\"/v1/videos\", { method: \"POST\", body: form });\n    return String((await this.json<{ video_id: string }>(res)).video_id);\n  }\n\n  async createRun(videoId: string, opts: CreateRunOptions = {}): Promise<Run> {\n    const body = JSON.stringify({\n      video_id: videoId,\n      creative_id: opts.creativeId ?? null,\n      with_audio: opts.withAudio ?? false,\n      audience: opts.audience ?? null,\n    });\n    const res = await this.req(\"/v1/runs\", {\n      method: \"POST\",\n      headers: { \"content-type\": \"application/json\" },\n      body,\n    });\n    return runFromApi(await this.json(res));\n  }\n\n  async getRun(runId: string): Promise<Run> {\n    return runFromApi(await this.json(await this.req(`/v1/runs/${runId}`)));\n  }\n\n  async listRuns(): Promise<RunListItem[]> {\n    const arr = await this.json<Record<string, unknown>[]>(await this.req(\"/v1/runs\"));\n    return arr.map(runListItemFromApi);\n  }\n\n  async getAccount(): Promise<Account> {\n    return accountFromApi(await this.json(await this.req(\"/v1/account\")));\n  }\n\n  private async calibForm(file: FileInput, filename: string): Promise<FormData> {\n    const { blob, name } = await toBlob(file, \"text/csv\");\n    const form = new FormData();\n    form.append(\"file\", blob, filename ?? name);\n    return form;\n  }\n\n  /** Step 1: detect columns and a guessed mapping for a performance CSV. */\n  async calibrationAnalyze(file: FileInput, filename = \"data.csv\"): Promise<unknown> {\n    const form = await this.calibForm(file, filename);\n    return this.json(await this.req(\"/v1/calibration/analyze\", { method: \"POST\", body: form }));\n  }\n\n  /** Step 2: summary (impression split, matched/processable, cost) — no charge. */\n  async calibrationPreview(\n    file: FileInput, mapping: Record<string, string>, minImpressions = 0, filename = \"data.csv\",\n  ): Promise<unknown> {\n    const form = await this.calibForm(file, filename);\n    form.append(\"mapping\", JSON.stringify(mapping));\n    form.append(\"min_impressions\", String(minImpressions));\n    return this.json(await this.req(\"/v1/calibration/preview\", { method: \"POST\", body: form }));\n  }\n\n  /** Step 3: charge, store actuals, fit calibration, queue unmatched videos. */\n  async calibrationCommit(\n    file: FileInput, mapping: Record<string, string>,\n    opts: { minImpressions?: number; processUnmatched?: boolean; filename?: string } = {},\n  ): Promise<unknown> {\n    const form = await this.calibForm(file, opts.filename ?? \"data.csv\");\n    form.append(\"mapping\", JSON.stringify(mapping));\n    form.append(\"min_impressions\", String(opts.minImpressions ?? 0));\n    form.append(\"process_unmatched\", String(opts.processUnmatched ?? false));\n    return this.json(await this.req(\"/v1/calibration/commit\", { method: \"POST\", body: form }));\n  }\n\n  /** Per-second analysis CSV (raw bytes). */\n  async getCsv(runId: string): Promise<Uint8Array> {\n    return this.bytes(await this.req(`/v1/runs/${runId}/data.csv`));\n  }\n\n  /** Gen-AI payload (parsed JSON). */\n  async getExport(runId: string): Promise<unknown> {\n    return this.json(await this.req(`/v1/runs/${runId}/export.json`));\n  }\n\n  /** PDF report bytes. kind is \"diagnose\" or \"analyze\". */\n  async getReport(runId: string, kind: \"diagnose\" | \"analyze\" = \"diagnose\"): Promise<Uint8Array> {\n    return this.bytes(await this.req(`/v1/runs/${runId}/report.pdf?kind=${encodeURIComponent(kind)}`));\n  }\n\n  /** Poll until the run reaches a terminal state. Rejects on failure/timeout. */\n  async wait(runId: string, opts: WaitOptions = {}): Promise<Run> {\n    const intervalMs = opts.intervalMs ?? 5_000;\n    const deadline = Date.now() + (opts.timeoutMs ?? 1_800_000);\n    for (;;) {\n      const run = await this.getRun(runId);\n      if (run.status === \"failed\") throw new RunFailedError(run.runId, run.error ?? undefined);\n      if (run.status === \"done\") return run;\n      if (Date.now() >= deadline) throw new WaitTimeout(`run ${runId} not done in time`);\n      await sleep(intervalMs);\n    }\n  }\n\n  /** Upload, start a run, and (by default) wait for it to finish. */\n  async analyze(file: FileInput, opts: AnalyzeOptions = {}): Promise<Run> {\n    const videoId = await this.uploadVideo(file, { filename: opts.filename });\n    const run = await this.createRun(videoId, opts);\n    if (opts.wait === false) return run;\n    return this.wait(run.runId, opts);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "creacortex",
+  "version": "0.2.0",
+  "description": "Node/TypeScript client for the Creacortex video-creative attention-analysis API",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "creacortex",
+    "video",
+    "advertising",
+    "attention",
+    "analytics",
+    "api",
+    "sdk"
+  ],
+  "license": "MIT",
+  "homepage": "https://creacortex.ai",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}