@byte_fluffy/nexra-sdk 0.1.0-alpha.39 → 0.1.0-alpha.40

package/README.md

@@ -108,6 +108,12 @@ parameter context, without adding serialized aliases. Use `nexraError.param`
 for new parameter handling. Public retry/category hints are removed; the SDK
 no longer exposes `NexraApiError.retryable`.
 
+`upstreamErrorMessage` is the original provider error text, preserving its
+language and line breaks. It is independent of the platform classification and
+is omitted when captured diagnostics contain no supported error text. Both SDK
+exception types expose this field. For older stored diagnostic bodies,
+`extractUpstreamErrorMessage(body)` uses the same extraction rules as the server.
+
 `upstreamError` contains captured provider error content. When an older captured
 body has its own `error` member, input normalization selects that member once;
 otherwise it retains the complete captured error body. An already canonical

package/dist/catalog.js

@@ -9,8 +9,8 @@ import {
   listModelSpecs,
   projectMediaGeometry,
   resolveNexraLanguageReasoning
-} from "./chunk-ZP34I6D7.js";
-import "./chunk-EFSKJCKB.js";
+} from "./chunk-Q4A3HJBX.js";
+import "./chunk-SIBYK5IX.js";
 export {
   CatalogClient,
   applyMediaGeometry,

package/dist/{chunk-ZP34I6D7.js → chunk-Q4A3HJBX.js}

@@ -2,7 +2,7 @@ import {
   normalizePublicErrorInput,
   pickPublicErrorFields,
   sortRatioDisplayOrder
-} from "./chunk-EFSKJCKB.js";
+} from "./chunk-SIBYK5IX.js";
 
 // src/catalog/generated/audio.generated.json
 var audio_generated_default = [
@@ -53040,6 +53040,7 @@ var NexraApiError = class extends Error {
   upstreamHttpStatus;
   upstreamRequestId;
   upstreamError;
+  upstreamErrorMessage;
   upstreamRedacted;
   upstreamTruncated;
   upstreamUnavailableReason;
@@ -53105,6 +53106,9 @@ var NexraTaskError = class extends Error {
   get upstreamError() {
     return this.publicFields.upstreamError;
   }
+  get upstreamErrorMessage() {
+    return this.publicFields.upstreamErrorMessage;
+  }
   get upstreamRedacted() {
     return this.publicFields.upstreamRedacted;
   }
@@ -53139,7 +53143,7 @@ var NexraWaitTimeoutError = class extends Error {
 };
 
 // src/generated/version.generated.ts
-var SDK_VERSION = "0.1.0-alpha.39";
+var SDK_VERSION = "0.1.0-alpha.40";
 
 // src/transport.ts
 var DEFAULT_BASE_URL = "https://api.nexra-ai.com/v1";

package/dist/{chunk-EFSKJCKB.js → chunk-SIBYK5IX.js}

@@ -8,311 +8,6 @@ var MEDIA_KINDS = [
   "other"
 ];
 
-// ../contracts/src/media-api.ts
-var NEXRA_MEDIA_API_VERSION = 1;
-var NEXRA_GENERATION_OPERATIONS = [
-  "text.generate",
-  "image.generate",
-  "video.generate",
-  "audio.generate",
-  "image.upscale",
-  "video.upscale"
-];
-var NEXRA_MEDIA_OPERATIONS = [
-  "image.generate",
-  "video.generate",
-  "audio.generate",
-  "image.upscale",
-  "video.upscale"
-];
-var NEXRA_PUBLISHED_MEDIA_OPERATIONS = [
-  "image.generate",
-  "video.generate",
-  "audio.generate",
-  "image.upscale"
-];
-var NEXRA_MEDIA_FEATURES = [
-  "text-to-image",
-  "image-to-image",
-  "image-reference",
-  "image-edit",
-  "image-inpaint",
-  "image-control",
-  "text-to-video",
-  "first-frame",
-  "first-last-frame",
-  "image-to-video",
-  "video-to-video",
-  "audio-to-video",
-  "avatar-video",
-  "reference-image",
-  "reference-video",
-  "reference-audio",
-  "omni-reference",
-  "tts",
-  "music",
-  "sfx",
-  "voice-reference",
-  "voice-design",
-  "scale-factor",
-  "target-resolution"
-];
-var NEXRA_MEDIA_OPERATION_DEFINITIONS = Object.freeze([
-  {
-    operation: "image.generate",
-    status: "active",
-    outputKind: "image",
-    features: ["text-to-image", "image-to-image", "image-reference", "image-edit", "image-inpaint", "image-control"],
-    parameterKeys: ["aspect_ratio", "resolution", "quality", "count", "output_format", "seed"]
-  },
-  {
-    operation: "video.generate",
-    status: "active",
-    outputKind: "video",
-    features: ["text-to-video", "first-frame", "first-last-frame", "image-to-video", "video-to-video", "audio-to-video", "avatar-video", "reference-image", "reference-video", "reference-audio", "omni-reference"],
-    parameterKeys: ["voice", "aspect_ratio", "resolution", "quality", "duration", "fit", "title", "generate_audio", "output_format", "seed", "watermark"]
-  },
-  {
-    operation: "audio.generate",
-    status: "active",
-    outputKind: "audio",
-    features: ["tts", "music", "sfx", "voice-reference", "voice-design"],
-    parameterKeys: ["voice", "language", "duration", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion", "instrumental", "loop", "prompt_influence", "seed"]
-  },
-  {
-    operation: "image.upscale",
-    status: "active",
-    outputKind: "image",
-    features: ["scale-factor", "target-resolution"],
-    parameterKeys: ["scale", "resolution", "output_format", "preserve_details"]
-  },
-  {
-    operation: "video.upscale",
-    status: "hold",
-    outputKind: "video",
-    features: ["scale-factor", "target-resolution"],
-    parameterKeys: ["scale", "resolution", "output_format", "preserve_details"]
-  }
-]);
-var mediaSourceSchema = {
-  oneOf: [
-    { type: "string", minLength: 1 },
-    {
-      type: "object",
-      properties: { assetId: { type: "string", minLength: 1 } },
-      required: ["assetId"],
-      additionalProperties: false
-    }
-  ]
-};
-function textPartSchema(roles) {
-  return {
-    type: "object",
-    properties: {
-      type: { const: "text" },
-      text: { type: "string", minLength: 1 },
-      role: { type: "string", enum: [...roles] }
-    },
-    required: ["type", "text"],
-    additionalProperties: false
-  };
-}
-function mediaPartSchema(type, roles) {
-  return {
-    type: "object",
-    properties: {
-      type: { const: type },
-      source: structuredClone(mediaSourceSchema),
-      role: { type: "string", enum: [...roles] },
-      ...type === "image" ? { name: { type: "string", minLength: 1, maxLength: 64, pattern: "^[^\\s@]+$" } } : {}
-    },
-    required: ["type", "source"],
-    additionalProperties: false
-  };
-}
-function inputSchema(contentItems, properties, contentBounds = {}) {
-  return {
-    $schema: "https://json-schema.org/draft/2020-12/schema",
-    type: "object",
-    properties: {
-      content: {
-        type: "array",
-        minItems: contentBounds.minItems ?? 1,
-        ...contentBounds.maxItems === void 0 ? {} : { maxItems: contentBounds.maxItems },
-        items: { oneOf: contentItems.map((item) => structuredClone(item)) },
-        "x-ui": { control: "content-parts", order: 0 }
-      },
-      ...properties
-    },
-    required: ["content"],
-    additionalProperties: false
-  };
-}
-var imagePart = mediaPartSchema("image", ["source", "reference", "first_frame", "last_frame", "mask", "control", "subject", "background"]);
-var videoImagePart = mediaPartSchema("image", ["source", "reference", "first_frame", "last_frame", "mask", "control", "subject", "background", "keyframe"]);
-var videoPart = mediaPartSchema("video", ["source", "reference", "edit", "extend"]);
-var audioPart = mediaPartSchema("audio", ["source", "reference", "voice_reference"]);
-var draftPart = {
-  type: "object",
-  properties: {
-    type: { const: "draft_task" },
-    draft_task: { type: "object", properties: { id: { type: "string", minLength: 1 } }, required: ["id"], additionalProperties: false }
-  },
-  required: ["type", "draft_task"],
-  additionalProperties: false
-};
-var NEXRA_MEDIA_INPUT_SCHEMAS = Object.freeze({
-  "image.generate": inputSchema(
-    [textPartSchema(["prompt", "negative_prompt"]), imagePart],
-    {
-      aspect_ratio: { type: "string", minLength: 1, "x-ui": { order: 10 } },
-      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
-      quality: { type: "string", minLength: 1, "x-ui": { order: 12 } },
-      count: { type: "integer", minimum: 1, "x-ui": { order: 13, control: "number" } },
-      output_format: { type: "string", minLength: 1, "x-ui": { order: 14 } },
-      seed: { type: "integer", minimum: 0, "x-ui": { order: 15, control: "number" } }
-    }
-  ),
-  "video.generate": inputSchema(
-    [textPartSchema(["prompt", "negative_prompt", "script"]), videoImagePart, videoPart, audioPart, draftPart],
-    {
-      task_type: { type: "string", minLength: 1, "x-ui": { order: 8, control: "segmented" } },
-      voice: { type: "string", minLength: 1, "x-ui": { order: 9, control: "resource", resource: "voice" } },
-      draft: { type: "boolean", "x-ui": { control: "switch" } },
-      watermark: { type: "boolean", const: false, "x-ui": { hidden: true } },
-      aspect_ratio: { type: "string", minLength: 1, "x-ui": { order: 10 } },
-      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
-      quality: { type: "string", minLength: 1, "x-ui": { order: 12 } },
-      duration: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 13, control: "number" } },
-      fit: { type: "string", enum: ["contain", "cover"], "x-ui": { order: 15, control: "segmented" } },
-      title: { type: "string", minLength: 1, "x-ui": { order: 16 } },
-      generate_audio: { type: "boolean", "x-ui": { order: 14, control: "switch" } },
-      output_format: { type: "string", minLength: 1, "x-ui": { order: 15 } },
-      seed: { type: "integer", minimum: 0, "x-ui": { order: 16, control: "number" } }
-    }
-  ),
-  "audio.generate": inputSchema(
-    [textPartSchema(["prompt", "script", "lyrics"]), audioPart],
-    {
-      voice: { type: "string", minLength: 1, "x-ui": { order: 10, control: "resource", resource: "voice" } },
-      language: { type: "string", minLength: 1, "x-ui": { order: 11 } },
-      duration: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 12, control: "number" } },
-      output_format: { type: "string", minLength: 1, "x-ui": { order: 13 } },
-      sample_rate: { type: "integer", minimum: 1, "x-ui": { order: 14, control: "number" } },
-      speed: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 15, control: "number" } },
-      volume: { type: "number", "x-ui": { order: 16, control: "number" } },
-      pitch: { type: "number", "x-ui": { order: 17, control: "number" } },
-      emotion: { type: "string", minLength: 1, "x-ui": { order: 18 } },
-      instrumental: { type: "boolean", "x-ui": { order: 19, control: "switch" } },
-      loop: { type: "boolean", "x-ui": { order: 20, control: "switch" } },
-      prompt_influence: { type: "number", minimum: 0, maximum: 1, "x-ui": { order: 21, control: "number" } },
-      seed: { type: "integer", minimum: 0, "x-ui": { order: 22, control: "number" } }
-    }
-  ),
-  "image.upscale": inputSchema(
-    [mediaPartSchema("image", ["source"])],
-    {
-      scale: { type: "number", exclusiveMinimum: 1, "x-ui": { order: 10, control: "number" } },
-      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
-      output_format: { type: "string", minLength: 1, "x-ui": { order: 12 } },
-      preserve_details: { type: "boolean", "x-ui": { order: 13, control: "switch" } }
-    },
-    { minItems: 1, maxItems: 1 }
-  )
-});
-function nexraMediaInputSchema(operation) {
-  if (!(operation in NEXRA_MEDIA_INPUT_SCHEMAS)) return void 0;
-  return structuredClone(NEXRA_MEDIA_INPUT_SCHEMAS[operation]);
-}
-function isNexraMediaInput(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-  const input = value;
-  if ("model" in input) return false;
-  const content = input.content;
-  return Array.isArray(content) && content.length > 0 && content.every((part) => {
-    if (!part || typeof part !== "object" || Array.isArray(part)) return false;
-    if (part.type === "text") return typeof part.text === "string" && part.text.length > 0;
-    if (part.type === "draft_task") {
-      const reference = part.draft_task;
-      return Boolean(reference && typeof reference === "object" && !Array.isArray(reference) && typeof reference.id === "string" && reference.id.length > 0);
-    }
-    if (!["image", "video", "audio"].includes(String(part.type))) return false;
-    if (typeof part.source === "string") return part.source.length > 0;
-    return Boolean(part.source && typeof part.source === "object" && !Array.isArray(part.source) && typeof part.source.assetId === "string" && part.source.assetId.length > 0);
-  });
-}
-function nexraMediaOperationForMode(mode) {
-  if (["text-to-image", "image-to-image"].includes(mode)) return "image.generate";
-  if (["text-to-video", "image-to-video", "multimodal-to-video", "avatar-video"].includes(mode)) return "video.generate";
-  if (["text-to-speech", "text-to-music", "text-to-sfx"].includes(mode)) return "audio.generate";
-  if (mode === "image-upscale") return "image.upscale";
-  return void 0;
-}
-function nexraMediaInputSchemaForMode(mode) {
-  const operation = nexraMediaOperationForMode(mode);
-  const schema = operation ? nexraMediaInputSchema(operation) : void 0;
-  if (!schema) return void 0;
-  const properties = schema.properties;
-  const content = properties.content;
-  const items = content.items;
-  const variants = Array.isArray(items.oneOf) ? items.oneOf : [];
-  if (mode === "avatar-video") {
-    for (const variant of variants) {
-      const variantProperties = variant.properties;
-      if (variantProperties.type.const === "text") {
-        variantProperties.role = { type: "string", enum: ["script"] };
-      }
-    }
-  }
-  const allowed = mode === "text-to-image" || mode === "text-to-video" || mode === "text-to-music" || mode === "text-to-sfx" ? /* @__PURE__ */ new Set(["text"]) : mode === "image-to-image" ? /* @__PURE__ */ new Set(["text", "image"]) : mode === "image-to-video" ? /* @__PURE__ */ new Set(["text", "image", "audio"]) : mode === "text-to-speech" ? /* @__PURE__ */ new Set(["text", "audio"]) : /* @__PURE__ */ new Set(["text", "image", "video", "audio"]);
-  items.oneOf = variants.filter((variant) => allowed.has(String(variant.properties.type.const)));
-  if (mode === "image-to-video") {
-    for (const variant of items.oneOf) {
-      const variantProperties = variant.properties;
-      if (variantProperties.type.const !== "image") continue;
-      variantProperties.role = { type: "string", enum: ["first_frame", "last_frame"] };
-      const required = new Set(Array.isArray(variant.required) ? variant.required.filter((key) => typeof key === "string") : []);
-      required.add("role");
-      variant.required = [...required];
-    }
-  }
-  if (mode === "multimodal-to-video") {
-    for (const variant of items.oneOf) {
-      const variantProperties = variant.properties;
-      const type = String(variantProperties.type.const);
-      if (!["image", "video", "audio"].includes(type)) continue;
-      variantProperties.role = type === "image" ? { type: "string", enum: ["reference", "subject", "background"] } : type === "video" ? { type: "string", enum: ["reference", "edit", "extend"] } : { type: "string", const: "reference" };
-      const required = new Set(Array.isArray(variant.required) ? variant.required.filter((key) => typeof key === "string") : []);
-      required.add("role");
-      variant.required = [...required];
-    }
-  }
-  const requiredMedia = mode === "image-to-image" || mode === "image-to-video" || mode === "avatar-video" ? "image" : void 0;
-  const requiresReferenceMedia = mode === "multimodal-to-video";
-  content.allOf = [
-    ...mode === "avatar-video" ? [] : [{
-      contains: { type: "object", properties: { type: { const: "text" } }, required: ["type"] },
-      minContains: 1
-    }],
-    ...requiredMedia ? [{
-      contains: { type: "object", properties: { type: { const: requiredMedia } }, required: ["type"] },
-      minContains: 1
-    }] : [],
-    ...requiresReferenceMedia ? [{
-      contains: { type: "object", properties: { type: { enum: ["image", "video", "audio"] } }, required: ["type"] },
-      minContains: 1
-    }] : []
-  ];
-  if (mode === "text-to-speech") {
-    properties.voice = { ...properties.voice, "x-ui": { order: 10, control: "resource", resource: "voice" } };
-  }
-  const allowedParameters = mode === "avatar-video" ? /* @__PURE__ */ new Set(["content", "voice", "aspect_ratio", "resolution"]) : mode === "text-to-speech" ? /* @__PURE__ */ new Set(["content", "voice", "language", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion"]) : mode === "text-to-music" ? /* @__PURE__ */ new Set(["content", "duration", "output_format", "instrumental", "prompt_influence", "seed"]) : mode === "text-to-sfx" ? /* @__PURE__ */ new Set(["content", "duration", "output_format", "loop", "prompt_influence", "seed"]) : void 0;
-  if (allowedParameters) {
-    schema.properties = Object.fromEntries(Object.entries(properties).filter(([key]) => allowedParameters.has(key)));
-  }
-  return schema;
-}
-
 // ../contracts/src/public-error-catalog.ts
 var PUBLIC_ERROR_CATALOG = {
   task_execution_timeout: { "zh-CN": "\u4EFB\u52A1\u8D85\u8FC7\u603B\u65F6\u9650\uFF0C\u5DF2\u7ED3\u675F\u3002\u4E0A\u6E38\u53EF\u80FD\u4ECD\u5728\u5904\u7406\uFF0C\u8BF7\u5148\u6838\u5BF9\u539F\u8BF7\u6C42\u7ED3\u679C\uFF0C\u907F\u514D\u91CD\u590D\u63D0\u4EA4\u3002", en: "The task exceeded its total time limit and has ended. The upstream service may still be processing it; check the original request before submitting again." },
@@ -601,69 +296,409 @@ function pickPublicErrorFields(input, context = {}) {
   const nexraHttpStatus = nexraRequestId ? status ?? (contextId === nexraRequestId ? httpStatus(context.nexraHttpStatus) : void 0) : void 0;
   const nexraError = pickNexraError(source);
   return {
-    ...nexraRequestId ? { nexraRequestId } : {},
-    ...nexraHttpStatus !== void 0 ? { nexraHttpStatus } : {},
-    ...nexraError ? { nexraError } : {},
-    ...flatUpstreamFields(owner, source)
+    ...nexraRequestId ? { nexraRequestId } : {},
+    ...nexraHttpStatus !== void 0 ? { nexraHttpStatus } : {},
+    ...nexraError ? { nexraError } : {},
+    ...flatUpstreamFields(owner, source)
+  };
+}
+function normalizePublicErrorInput(input, context = {}) {
+  const fields = pickPublicErrorFields(input, context);
+  return fields.nexraError ? { ...fields, nexraError: fields.nexraError } : void 0;
+}
+function flatUpstreamFields(owner, source) {
+  const legacy = evidenceFields(source).upstream;
+  const field = (key, fallback) => Object.hasOwn(owner, key) ? owner[key] : Object.hasOwn(source, key) ? source[key] : fallback;
+  const body = Object.hasOwn(owner, "upstreamError") ? owner.upstreamError : Object.hasOwn(source, "upstreamError") ? source.upstreamError : legacy?.body !== null && typeof legacy?.body === "object" && Object.hasOwn(legacy.body, "error") ? legacy.body.error : legacy?.body;
+  const upstream = pickPublicUpstreamError({
+    upstreamHttpStatus: field("upstreamHttpStatus", legacy?.upstreamHttpStatus),
+    upstreamRequestId: field("upstreamRequestId", legacy?.upstreamRequestId),
+    ...body !== void 0 ? { body } : {},
+    redacted: field("upstreamRedacted", legacy?.redacted),
+    truncated: field("upstreamTruncated", legacy?.truncated),
+    format: field("upstreamFormat", legacy?.format),
+    event: field("upstreamEvent", legacy?.event),
+    unavailableReason: field("upstreamUnavailableReason", legacy?.unavailableReason)
+  });
+  const explicitMessage = field("upstreamErrorMessage");
+  const upstreamErrorMessage = typeof explicitMessage === "string" && explicitMessage.trim() ? explicitMessage : extractUpstreamErrorMessage(upstream?.body);
+  return {
+    ...upstreamErrorMessage !== void 0 ? { upstreamErrorMessage } : {},
+    ...upstream?.upstreamHttpStatus !== void 0 ? { upstreamHttpStatus: upstream.upstreamHttpStatus } : {},
+    ...upstream?.upstreamRequestId ? { upstreamRequestId: upstream.upstreamRequestId } : {},
+    ...upstream && Object.hasOwn(upstream, "body") ? { upstreamError: upstream.body } : {},
+    ...upstream?.redacted ? { upstreamRedacted: true } : {},
+    ...upstream?.truncated ? { upstreamTruncated: true } : {},
+    ...upstream?.format ? { upstreamFormat: upstream.format } : {},
+    ...upstream?.event ? { upstreamEvent: upstream.event } : {},
+    ...upstream?.unavailableReason ? { upstreamUnavailableReason: upstream.unavailableReason } : {}
+  };
+}
+function upstreamUnavailableReason(value) {
+  return value === "no_response" || value === "not_retained" || value === "unsupported_capture" || value === "error_not_emitted" || value === "size_limit" ? value : void 0;
+}
+function extractUpstreamErrorMessage(value) {
+  const visited = /* @__PURE__ */ new WeakSet();
+  const read = (candidate, depth) => {
+    if (typeof candidate === "string") return candidate.trim() ? candidate : void 0;
+    if (depth > 8 || !candidate || typeof candidate !== "object" || visited.has(candidate)) return void 0;
+    visited.add(candidate);
+    if (Array.isArray(candidate)) {
+      const messages = candidate.flatMap((item) => read(item, depth + 1) ?? []);
+      return messages.length ? messages.join("\n") : void 0;
+    }
+    const record = candidate;
+    for (const key of ["error", "Error"]) {
+      const message = read(record[key], depth + 1);
+      if (message) return message;
+    }
+    for (const key of ["errorMessage", "failure_reason", "status_message", "errMsg"]) {
+      const message = record[key];
+      if (typeof message === "string" && message.trim()) return message;
+    }
+    for (const key of ["base_resp", "detail", "output", "task", "data", "response", "Response", "videoGenerateTaskInfo", "steps"]) {
+      if (key === "base_resp" && isRecord(record[key]) && record[key].status_code === 0) continue;
+      const message = read(record[key], depth + 1);
+      if (message) return message;
+    }
+    for (const key of ["message", "msg", "status_msg"]) {
+      const message = record[key];
+      if (typeof message === "string" && message.trim()) return message;
+    }
+    return void 0;
+  };
+  return read(value, 0);
+}
+function identifier(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+function httpStatus(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599 ? value : void 0;
+}
+function resolvePublicErrorLocale(acceptLanguage) {
+  let chosen = "en";
+  let highestQuality = 0;
+  for (const candidate of (acceptLanguage ?? "").split(",")) {
+    const [tag, ...parameters] = candidate.trim().toLowerCase().split(";");
+    const locale = /^zh(?:-[a-z0-9]+)*$/.test(tag ?? "") ? "zh-CN" : /^en(?:-[a-z0-9]+)*$/.test(tag ?? "") ? "en" : void 0;
+    if (!locale) continue;
+    const qualityParameter = parameters.map((parameter) => parameter.trim()).find((parameter) => parameter.startsWith("q="));
+    const rawQuality = qualityParameter?.slice(2).trim();
+    const quality = rawQuality === void 0 ? 1 : /^(?:0(?:\.\d{0,3})?|1(?:\.0{0,3})?)$/.test(rawQuality) ? Number(rawQuality) : 0;
+    if (quality > highestQuality) {
+      chosen = locale;
+      highestQuality = quality;
+    }
+  }
+  return chosen;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// ../contracts/src/media-api.ts
+var NEXRA_MEDIA_API_VERSION = 1;
+var NEXRA_GENERATION_OPERATIONS = [
+  "text.generate",
+  "image.generate",
+  "video.generate",
+  "audio.generate",
+  "image.upscale",
+  "video.upscale"
+];
+var NEXRA_MEDIA_OPERATIONS = [
+  "image.generate",
+  "video.generate",
+  "audio.generate",
+  "image.upscale",
+  "video.upscale"
+];
+var NEXRA_PUBLISHED_MEDIA_OPERATIONS = [
+  "image.generate",
+  "video.generate",
+  "audio.generate",
+  "image.upscale"
+];
+var NEXRA_MEDIA_FEATURES = [
+  "text-to-image",
+  "image-to-image",
+  "image-reference",
+  "image-edit",
+  "image-inpaint",
+  "image-control",
+  "text-to-video",
+  "first-frame",
+  "first-last-frame",
+  "image-to-video",
+  "video-to-video",
+  "audio-to-video",
+  "avatar-video",
+  "reference-image",
+  "reference-video",
+  "reference-audio",
+  "omni-reference",
+  "tts",
+  "music",
+  "sfx",
+  "voice-reference",
+  "voice-design",
+  "scale-factor",
+  "target-resolution"
+];
+var NEXRA_MEDIA_OPERATION_DEFINITIONS = Object.freeze([
+  {
+    operation: "image.generate",
+    status: "active",
+    outputKind: "image",
+    features: ["text-to-image", "image-to-image", "image-reference", "image-edit", "image-inpaint", "image-control"],
+    parameterKeys: ["aspect_ratio", "resolution", "quality", "count", "output_format", "seed"]
+  },
+  {
+    operation: "video.generate",
+    status: "active",
+    outputKind: "video",
+    features: ["text-to-video", "first-frame", "first-last-frame", "image-to-video", "video-to-video", "audio-to-video", "avatar-video", "reference-image", "reference-video", "reference-audio", "omni-reference"],
+    parameterKeys: ["voice", "aspect_ratio", "resolution", "quality", "duration", "fit", "title", "generate_audio", "output_format", "seed", "watermark"]
+  },
+  {
+    operation: "audio.generate",
+    status: "active",
+    outputKind: "audio",
+    features: ["tts", "music", "sfx", "voice-reference", "voice-design"],
+    parameterKeys: ["voice", "language", "duration", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion", "instrumental", "loop", "prompt_influence", "seed"]
+  },
+  {
+    operation: "image.upscale",
+    status: "active",
+    outputKind: "image",
+    features: ["scale-factor", "target-resolution"],
+    parameterKeys: ["scale", "resolution", "output_format", "preserve_details"]
+  },
+  {
+    operation: "video.upscale",
+    status: "hold",
+    outputKind: "video",
+    features: ["scale-factor", "target-resolution"],
+    parameterKeys: ["scale", "resolution", "output_format", "preserve_details"]
+  }
+]);
+var mediaSourceSchema = {
+  oneOf: [
+    { type: "string", minLength: 1 },
+    {
+      type: "object",
+      properties: { assetId: { type: "string", minLength: 1 } },
+      required: ["assetId"],
+      additionalProperties: false
+    }
+  ]
+};
+function textPartSchema(roles) {
+  return {
+    type: "object",
+    properties: {
+      type: { const: "text" },
+      text: { type: "string", minLength: 1 },
+      role: { type: "string", enum: [...roles] }
+    },
+    required: ["type", "text"],
+    additionalProperties: false
   };
 }
-function normalizePublicErrorInput(input, context = {}) {
-  const fields = pickPublicErrorFields(input, context);
-  return fields.nexraError ? { ...fields, nexraError: fields.nexraError } : void 0;
+function mediaPartSchema(type, roles) {
+  return {
+    type: "object",
+    properties: {
+      type: { const: type },
+      source: structuredClone(mediaSourceSchema),
+      role: { type: "string", enum: [...roles] },
+      ...type === "image" ? { name: { type: "string", minLength: 1, maxLength: 64, pattern: "^[^\\s@]+$" } } : {}
+    },
+    required: ["type", "source"],
+    additionalProperties: false
+  };
 }
-function flatUpstreamFields(owner, source) {
-  const legacy = evidenceFields(source).upstream;
-  const field = (key, fallback) => Object.hasOwn(owner, key) ? owner[key] : Object.hasOwn(source, key) ? source[key] : fallback;
-  const body = Object.hasOwn(owner, "upstreamError") ? owner.upstreamError : Object.hasOwn(source, "upstreamError") ? source.upstreamError : legacy?.body !== null && typeof legacy?.body === "object" && Object.hasOwn(legacy.body, "error") ? legacy.body.error : legacy?.body;
-  const upstream = pickPublicUpstreamError({
-    upstreamHttpStatus: field("upstreamHttpStatus", legacy?.upstreamHttpStatus),
-    upstreamRequestId: field("upstreamRequestId", legacy?.upstreamRequestId),
-    ...body !== void 0 ? { body } : {},
-    redacted: field("upstreamRedacted", legacy?.redacted),
-    truncated: field("upstreamTruncated", legacy?.truncated),
-    format: field("upstreamFormat", legacy?.format),
-    event: field("upstreamEvent", legacy?.event),
-    unavailableReason: field("upstreamUnavailableReason", legacy?.unavailableReason)
-  });
+function inputSchema(contentItems, properties, contentBounds = {}) {
   return {
-    ...upstream?.upstreamHttpStatus !== void 0 ? { upstreamHttpStatus: upstream.upstreamHttpStatus } : {},
-    ...upstream?.upstreamRequestId ? { upstreamRequestId: upstream.upstreamRequestId } : {},
-    ...upstream && Object.hasOwn(upstream, "body") ? { upstreamError: upstream.body } : {},
-    ...upstream?.redacted ? { upstreamRedacted: true } : {},
-    ...upstream?.truncated ? { upstreamTruncated: true } : {},
-    ...upstream?.format ? { upstreamFormat: upstream.format } : {},
-    ...upstream?.event ? { upstreamEvent: upstream.event } : {},
-    ...upstream?.unavailableReason ? { upstreamUnavailableReason: upstream.unavailableReason } : {}
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    type: "object",
+    properties: {
+      content: {
+        type: "array",
+        minItems: contentBounds.minItems ?? 1,
+        ...contentBounds.maxItems === void 0 ? {} : { maxItems: contentBounds.maxItems },
+        items: { oneOf: contentItems.map((item) => structuredClone(item)) },
+        "x-ui": { control: "content-parts", order: 0 }
+      },
+      ...properties
+    },
+    required: ["content"],
+    additionalProperties: false
   };
 }
-function upstreamUnavailableReason(value) {
-  return value === "no_response" || value === "not_retained" || value === "unsupported_capture" || value === "error_not_emitted" || value === "size_limit" ? value : void 0;
+var imagePart = mediaPartSchema("image", ["source", "reference", "first_frame", "last_frame", "mask", "control", "subject", "background"]);
+var videoImagePart = mediaPartSchema("image", ["source", "reference", "first_frame", "last_frame", "mask", "control", "subject", "background", "keyframe"]);
+var videoPart = mediaPartSchema("video", ["source", "reference", "edit", "extend"]);
+var audioPart = mediaPartSchema("audio", ["source", "reference", "voice_reference"]);
+var draftPart = {
+  type: "object",
+  properties: {
+    type: { const: "draft_task" },
+    draft_task: { type: "object", properties: { id: { type: "string", minLength: 1 } }, required: ["id"], additionalProperties: false }
+  },
+  required: ["type", "draft_task"],
+  additionalProperties: false
+};
+var NEXRA_MEDIA_INPUT_SCHEMAS = Object.freeze({
+  "image.generate": inputSchema(
+    [textPartSchema(["prompt", "negative_prompt"]), imagePart],
+    {
+      aspect_ratio: { type: "string", minLength: 1, "x-ui": { order: 10 } },
+      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      quality: { type: "string", minLength: 1, "x-ui": { order: 12 } },
+      count: { type: "integer", minimum: 1, "x-ui": { order: 13, control: "number" } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 14 } },
+      seed: { type: "integer", minimum: 0, "x-ui": { order: 15, control: "number" } }
+    }
+  ),
+  "video.generate": inputSchema(
+    [textPartSchema(["prompt", "negative_prompt", "script"]), videoImagePart, videoPart, audioPart, draftPart],
+    {
+      task_type: { type: "string", minLength: 1, "x-ui": { order: 8, control: "segmented" } },
+      voice: { type: "string", minLength: 1, "x-ui": { order: 9, control: "resource", resource: "voice" } },
+      draft: { type: "boolean", "x-ui": { control: "switch" } },
+      watermark: { type: "boolean", const: false, "x-ui": { hidden: true } },
+      aspect_ratio: { type: "string", minLength: 1, "x-ui": { order: 10 } },
+      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      quality: { type: "string", minLength: 1, "x-ui": { order: 12 } },
+      duration: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 13, control: "number" } },
+      fit: { type: "string", enum: ["contain", "cover"], "x-ui": { order: 15, control: "segmented" } },
+      title: { type: "string", minLength: 1, "x-ui": { order: 16 } },
+      generate_audio: { type: "boolean", "x-ui": { order: 14, control: "switch" } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 15 } },
+      seed: { type: "integer", minimum: 0, "x-ui": { order: 16, control: "number" } }
+    }
+  ),
+  "audio.generate": inputSchema(
+    [textPartSchema(["prompt", "script", "lyrics"]), audioPart],
+    {
+      voice: { type: "string", minLength: 1, "x-ui": { order: 10, control: "resource", resource: "voice" } },
+      language: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      duration: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 12, control: "number" } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 13 } },
+      sample_rate: { type: "integer", minimum: 1, "x-ui": { order: 14, control: "number" } },
+      speed: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 15, control: "number" } },
+      volume: { type: "number", "x-ui": { order: 16, control: "number" } },
+      pitch: { type: "number", "x-ui": { order: 17, control: "number" } },
+      emotion: { type: "string", minLength: 1, "x-ui": { order: 18 } },
+      instrumental: { type: "boolean", "x-ui": { order: 19, control: "switch" } },
+      loop: { type: "boolean", "x-ui": { order: 20, control: "switch" } },
+      prompt_influence: { type: "number", minimum: 0, maximum: 1, "x-ui": { order: 21, control: "number" } },
+      seed: { type: "integer", minimum: 0, "x-ui": { order: 22, control: "number" } }
+    }
+  ),
+  "image.upscale": inputSchema(
+    [mediaPartSchema("image", ["source"])],
+    {
+      scale: { type: "number", exclusiveMinimum: 1, "x-ui": { order: 10, control: "number" } },
+      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 12 } },
+      preserve_details: { type: "boolean", "x-ui": { order: 13, control: "switch" } }
+    },
+    { minItems: 1, maxItems: 1 }
+  )
+});
+function nexraMediaInputSchema(operation) {
+  if (!(operation in NEXRA_MEDIA_INPUT_SCHEMAS)) return void 0;
+  return structuredClone(NEXRA_MEDIA_INPUT_SCHEMAS[operation]);
 }
-function identifier(value) {
-  return typeof value === "string" && value.trim() ? value : void 0;
+function isNexraMediaInput(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const input = value;
+  if ("model" in input) return false;
+  const content = input.content;
+  return Array.isArray(content) && content.length > 0 && content.every((part) => {
+    if (!part || typeof part !== "object" || Array.isArray(part)) return false;
+    if (part.type === "text") return typeof part.text === "string" && part.text.length > 0;
+    if (part.type === "draft_task") {
+      const reference = part.draft_task;
+      return Boolean(reference && typeof reference === "object" && !Array.isArray(reference) && typeof reference.id === "string" && reference.id.length > 0);
+    }
+    if (!["image", "video", "audio"].includes(String(part.type))) return false;
+    if (typeof part.source === "string") return part.source.length > 0;
+    return Boolean(part.source && typeof part.source === "object" && !Array.isArray(part.source) && typeof part.source.assetId === "string" && part.source.assetId.length > 0);
+  });
 }
-function httpStatus(value) {
-  return typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599 ? value : void 0;
+function nexraMediaOperationForMode(mode) {
+  if (["text-to-image", "image-to-image"].includes(mode)) return "image.generate";
+  if (["text-to-video", "image-to-video", "multimodal-to-video", "avatar-video"].includes(mode)) return "video.generate";
+  if (["text-to-speech", "text-to-music", "text-to-sfx"].includes(mode)) return "audio.generate";
+  if (mode === "image-upscale") return "image.upscale";
+  return void 0;
 }
-function resolvePublicErrorLocale(acceptLanguage) {
-  let chosen = "en";
-  let highestQuality = 0;
-  for (const candidate of (acceptLanguage ?? "").split(",")) {
-    const [tag, ...parameters] = candidate.trim().toLowerCase().split(";");
-    const locale = /^zh(?:-[a-z0-9]+)*$/.test(tag ?? "") ? "zh-CN" : /^en(?:-[a-z0-9]+)*$/.test(tag ?? "") ? "en" : void 0;
-    if (!locale) continue;
-    const qualityParameter = parameters.map((parameter) => parameter.trim()).find((parameter) => parameter.startsWith("q="));
-    const rawQuality = qualityParameter?.slice(2).trim();
-    const quality = rawQuality === void 0 ? 1 : /^(?:0(?:\.\d{0,3})?|1(?:\.0{0,3})?)$/.test(rawQuality) ? Number(rawQuality) : 0;
-    if (quality > highestQuality) {
-      chosen = locale;
-      highestQuality = quality;
+function nexraMediaInputSchemaForMode(mode) {
+  const operation = nexraMediaOperationForMode(mode);
+  const schema = operation ? nexraMediaInputSchema(operation) : void 0;
+  if (!schema) return void 0;
+  const properties = schema.properties;
+  const content = properties.content;
+  const items = content.items;
+  const variants = Array.isArray(items.oneOf) ? items.oneOf : [];
+  if (mode === "avatar-video") {
+    for (const variant of variants) {
+      const variantProperties = variant.properties;
+      if (variantProperties.type.const === "text") {
+        variantProperties.role = { type: "string", enum: ["script"] };
+      }
     }
   }
-  return chosen;
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+  const allowed = mode === "text-to-image" || mode === "text-to-video" || mode === "text-to-music" || mode === "text-to-sfx" ? /* @__PURE__ */ new Set(["text"]) : mode === "image-to-image" ? /* @__PURE__ */ new Set(["text", "image"]) : mode === "image-to-video" ? /* @__PURE__ */ new Set(["text", "image", "audio"]) : mode === "text-to-speech" ? /* @__PURE__ */ new Set(["text", "audio"]) : /* @__PURE__ */ new Set(["text", "image", "video", "audio"]);
+  items.oneOf = variants.filter((variant) => allowed.has(String(variant.properties.type.const)));
+  if (mode === "image-to-video") {
+    for (const variant of items.oneOf) {
+      const variantProperties = variant.properties;
+      if (variantProperties.type.const !== "image") continue;
+      variantProperties.role = { type: "string", enum: ["first_frame", "last_frame"] };
+      const required = new Set(Array.isArray(variant.required) ? variant.required.filter((key) => typeof key === "string") : []);
+      required.add("role");
+      variant.required = [...required];
+    }
+  }
+  if (mode === "multimodal-to-video") {
+    for (const variant of items.oneOf) {
+      const variantProperties = variant.properties;
+      const type = String(variantProperties.type.const);
+      if (!["image", "video", "audio"].includes(type)) continue;
+      variantProperties.role = type === "image" ? { type: "string", enum: ["reference", "subject", "background"] } : type === "video" ? { type: "string", enum: ["reference", "edit", "extend"] } : { type: "string", const: "reference" };
+      const required = new Set(Array.isArray(variant.required) ? variant.required.filter((key) => typeof key === "string") : []);
+      required.add("role");
+      variant.required = [...required];
+    }
+  }
+  const requiredMedia = mode === "image-to-image" || mode === "image-to-video" || mode === "avatar-video" ? "image" : void 0;
+  const requiresReferenceMedia = mode === "multimodal-to-video";
+  content.allOf = [
+    ...mode === "avatar-video" ? [] : [{
+      contains: { type: "object", properties: { type: { const: "text" } }, required: ["type"] },
+      minContains: 1
+    }],
+    ...requiredMedia ? [{
+      contains: { type: "object", properties: { type: { const: requiredMedia } }, required: ["type"] },
+      minContains: 1
+    }] : [],
+    ...requiresReferenceMedia ? [{
+      contains: { type: "object", properties: { type: { enum: ["image", "video", "audio"] } }, required: ["type"] },
+      minContains: 1
+    }] : []
+  ];
+  if (mode === "text-to-speech") {
+    properties.voice = { ...properties.voice, "x-ui": { order: 10, control: "resource", resource: "voice" } };
+  }
+  const allowedParameters = mode === "avatar-video" ? /* @__PURE__ */ new Set(["content", "voice", "aspect_ratio", "resolution"]) : mode === "text-to-speech" ? /* @__PURE__ */ new Set(["content", "voice", "language", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion"]) : mode === "text-to-music" ? /* @__PURE__ */ new Set(["content", "duration", "output_format", "instrumental", "prompt_influence", "seed"]) : mode === "text-to-sfx" ? /* @__PURE__ */ new Set(["content", "duration", "output_format", "loop", "prompt_influence", "seed"]) : void 0;
+  if (allowedParameters) {
+    schema.properties = Object.fromEntries(Object.entries(properties).filter(([key]) => allowedParameters.has(key)));
+  }
+  return schema;
 }
 
 // ../contracts/src/tasks.ts
@@ -764,6 +799,7 @@ export {
   publicErrorMessage,
   pickPublicErrorFields,
   normalizePublicErrorInput,
+  extractUpstreamErrorMessage,
   resolvePublicErrorLocale,
   NEXRA_MEDIA_API_VERSION,
   NEXRA_GENERATION_OPERATIONS,

package/dist/{errors-DZlSwyv8.d.ts → errors-DJZuAKoO.d.ts}

@@ -16,6 +16,7 @@ type PublicErrorFields = PublicErrorContext & {
     upstreamHttpStatus?: number;
     upstreamRequestId?: string;
     upstreamError?: JsonValue;
+    upstreamErrorMessage?: string;
     upstreamRedacted?: true;
     upstreamTruncated?: true;
     upstreamUnavailableReason?: PublicUpstreamUnavailableReason;
@@ -26,5 +27,7 @@ type PublicError = PublicErrorFields & {
     nexraError: NexraError;
 };
 type ApiErrorPayload = PublicError;
+/** Extracts text only from known provider error fields, never arbitrary metadata. */
+declare function extractUpstreamErrorMessage(value: unknown): string | undefined;
 
-export type { ApiErrorPayload as A, NexraError as N, PublicErrorFields as P, PublicError as a, PublicErrorContext as b };
+export { type ApiErrorPayload as A, type NexraError as N, type PublicErrorFields as P, type PublicError as a, type PublicErrorContext as b, extractUpstreamErrorMessage as e };

package/dist/index.d.ts

@@ -3,10 +3,10 @@ import { H as HttpTransport, M as ModelSearchParams, T as TaskModelSummary, a as
 export { C as CreateNexraDisplayQuoteBatchRequest, d as CreateNexraQuoteRequest, F as FetchLike, e as MediaGeometryField, f as MediaGeometryProjection, g as ModelCapabilitySummary, h as ModelDateVersion, i as ModelEndpointSummary, j as ModelModality, k as ModelResourceOption, l as NexraBillingCurrency, m as NexraCatalogRevision, n as NexraDisplayQuoteBatch, o as NexraDisplayQuoteBatchEntry, p as NexraModelOperation, q as NexraModelSpec, r as NexraModelSpecFilter, s as NexraQuote, t as NexraSalePrice, u as NexraSalePriceList, v as NexraSettlement, U as UnifiedMediaGeometry, w as applyMediaGeometry, x as decodeMediaGeometry, y as encodeMediaGeometry, z as projectMediaGeometry } from './media-geometry-YD9Y_CFw.js';
 import { C as CursorPage, J as JsonValue } from './json-Cz0MkWQn.js';
 export { a as JsonObject, b as JsonPrimitive } from './json-Cz0MkWQn.js';
-import { N as NexraError, P as PublicErrorFields } from './errors-DZlSwyv8.js';
-export { A as ApiErrorPayload, a as PublicError, b as PublicErrorContext } from './errors-DZlSwyv8.js';
-import { V as Voice, C as CreateVoiceRequest, a as VoiceCreation, A as AssetsClient, T as TasksClient, R as RunTaskOptions, b as RunResult, c as TaskResult } from './voices-BXToLr8g.js';
-export { d as CreateTaskOptions, e as CreateTaskRequest, f as RequestDetails, g as TASK_STATUSES, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, W as WaitTaskOptions, v as WatchTaskOptions, w as isTerminalTaskStatus, x as verifyWebhook } from './voices-BXToLr8g.js';
+import { N as NexraError, P as PublicErrorFields } from './errors-DJZuAKoO.js';
+export { A as ApiErrorPayload, a as PublicError, b as PublicErrorContext, e as extractUpstreamErrorMessage } from './errors-DJZuAKoO.js';
+import { V as Voice, C as CreateVoiceRequest, a as VoiceCreation, A as AssetsClient, T as TasksClient, R as RunTaskOptions, b as RunResult, c as TaskResult } from './voices-BHzDQ5xH.js';
+export { d as CreateTaskOptions, e as CreateTaskRequest, f as RequestDetails, g as TASK_STATUSES, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, W as WaitTaskOptions, v as WatchTaskOptions, w as isTerminalTaskStatus, x as verifyWebhook } from './voices-BHzDQ5xH.js';
 import { CatalogClient } from './catalog.js';
 export { formatModelDisplayName, getModelSpec, listModelSpecs } from './catalog.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';
@@ -59,6 +59,7 @@ declare class NexraApiError extends Error {
     readonly upstreamHttpStatus?: PublicErrorFields["upstreamHttpStatus"];
     readonly upstreamRequestId?: string;
     readonly upstreamError?: PublicErrorFields["upstreamError"];
+    readonly upstreamErrorMessage?: string;
     readonly upstreamRedacted?: true;
     readonly upstreamTruncated?: true;
     readonly upstreamUnavailableReason?: PublicErrorFields["upstreamUnavailableReason"];
@@ -95,6 +96,7 @@ declare class NexraTaskError extends Error {
     get upstreamHttpStatus(): PublicErrorFields["upstreamHttpStatus"];
     get upstreamRequestId(): string | undefined;
     get upstreamError(): PublicErrorFields["upstreamError"];
+    get upstreamErrorMessage(): string | undefined;
     get upstreamRedacted(): true | undefined;
     get upstreamTruncated(): true | undefined;
     get upstreamUnavailableReason(): PublicErrorFields["upstreamUnavailableReason"];

package/dist/index.js

@@ -20,13 +20,14 @@ import {
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-ZP34I6D7.js";
+} from "./chunk-Q4A3HJBX.js";
 import {
   MEDIA_KINDS,
   TASK_STATUSES,
   createTaskRequest,
+  extractUpstreamErrorMessage,
   isTerminalTaskStatus
-} from "./chunk-EFSKJCKB.js";
+} from "./chunk-SIBYK5IX.js";
 
 // src/assets.ts
 var AssetsClient = class {
@@ -500,6 +501,7 @@ export {
   createNexra,
   decodeMediaGeometry,
   encodeMediaGeometry,
+  extractUpstreamErrorMessage,
   formatModelDisplayName,
   getModelSpec,
   isTerminalTaskStatus,

package/dist/language.d.ts

@@ -2,7 +2,7 @@ import { APICallError, LanguageModelV4 } from '@ai-sdk/provider';
 import { NexraLanguageProtocol } from './catalog.js';
 export { NexraLanguageModelBinding } from './catalog.js';
 import { F as FetchLike } from './media-geometry-YD9Y_CFw.js';
-import { N as NexraError } from './errors-DZlSwyv8.js';
+import { N as NexraError } from './errors-DJZuAKoO.js';
 import './json-Cz0MkWQn.js';
 
 type NativeErrorContext = {

package/dist/language.js

@@ -6,12 +6,12 @@ import {
   jsonBody,
   parseServerSentEvents,
   resolveNexraLanguageReasoning
-} from "./chunk-ZP34I6D7.js";
+} from "./chunk-Q4A3HJBX.js";
 import {
   isPublicErrorCode,
   publicErrorMessage,
   resolvePublicErrorLocale
-} from "./chunk-EFSKJCKB.js";
+} from "./chunk-SIBYK5IX.js";
 
 // src/language/index.ts
 import { createAnthropic } from "@ai-sdk/anthropic";

package/dist/media.js

@@ -10,7 +10,7 @@ import {
   nexraMediaInputSchema,
   nexraMediaInputSchemaForMode,
   nexraMediaOperationForMode
-} from "./chunk-EFSKJCKB.js";
+} from "./chunk-SIBYK5IX.js";
 export {
   NEXRA_GENERATION_OPERATIONS,
   NEXRA_MEDIA_API_VERSION,

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 export { A as AssetImportRequest, a as AssetInput, b as AssetReference, c as AssetUploadOptions, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-Cusrjj7_.js';
 export { C as CreateNexraDisplayQuoteBatchRequest, d as CreateNexraQuoteRequest, F as FetchLike, e as MediaGeometryField, f as MediaGeometryProjection, g as ModelCapabilitySummary, h as ModelDateVersion, i as ModelEndpointSummary, j as ModelModality, c as ModelResourceList, k as ModelResourceOption, b as ModelSchema, M as ModelSearchParams, l as NexraBillingCurrency, m as NexraCatalogRevision, N as NexraClientOptions, n as NexraDisplayQuoteBatch, o as NexraDisplayQuoteBatchEntry, p as NexraModelOperation, q as NexraModelSpec, r as NexraModelSpecFilter, s as NexraQuote, t as NexraSalePrice, u as NexraSalePriceList, v as NexraSettlement, a as TaskModel, T as TaskModelSummary, U as UnifiedMediaGeometry } from './media-geometry-YD9Y_CFw.js';
 export { C as CursorPage, a as JsonObject, b as JsonPrimitive, J as JsonValue } from './json-Cz0MkWQn.js';
-export { A as ApiErrorPayload, N as NexraError, a as PublicError, b as PublicErrorContext, P as PublicErrorFields } from './errors-DZlSwyv8.js';
-export { d as CreateTaskOptions, e as CreateTaskRequest, C as CreateVoiceRequest, f as RequestDetails, b as RunResult, R as RunTaskOptions, c as Task, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, c as TaskResult, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, V as Voice, a as VoiceCreation, W as WaitTaskOptions, v as WatchTaskOptions } from './voices-BXToLr8g.js';
+export { A as ApiErrorPayload, N as NexraError, a as PublicError, b as PublicErrorContext, P as PublicErrorFields } from './errors-DJZuAKoO.js';
+export { d as CreateTaskOptions, e as CreateTaskRequest, C as CreateVoiceRequest, f as RequestDetails, b as RunResult, R as RunTaskOptions, c as Task, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, c as TaskResult, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, V as Voice, a as VoiceCreation, W as WaitTaskOptions, v as WatchTaskOptions } from './voices-BHzDQ5xH.js';

package/dist/{voices-BXToLr8g.d.ts → voices-BHzDQ5xH.d.ts}

@@ -1,7 +1,7 @@
 import { c as AssetUploadOptions, d as MediaAsset, A as AssetImportRequest, g as AssetCertificationRequest, h as AssetCertification, i as AssetCertificationWaitOptions } from './assets-Cusrjj7_.js';
 import { H as HttpTransport, v as NexraSettlement } from './media-geometry-YD9Y_CFw.js';
 import { a as JsonObject, J as JsonValue, C as CursorPage } from './json-Cz0MkWQn.js';
-import { P as PublicErrorFields, a as PublicError, b as PublicErrorContext, N as NexraError } from './errors-DZlSwyv8.js';
+import { P as PublicErrorFields, a as PublicError, b as PublicErrorContext, N as NexraError } from './errors-DJZuAKoO.js';
 
 declare class AssetsClient {
     private readonly transport;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byte_fluffy/nexra-sdk",
-  "version": "0.1.0-alpha.39",
+  "version": "0.1.0-alpha.40",
   "type": "module",
   "types": "./dist/index.d.ts",
   "sideEffects": false,