@byte_fluffy/nexra-sdk 0.1.0-alpha.24 → 0.1.0-alpha.26

package/dist/{chunk-TA3YGQQY.js → chunk-KEAAHI25.js}

@@ -53,6 +53,7 @@ var NEXRA_MEDIA_FEATURES = [
   "music",
   "sfx",
   "voice-reference",
+  "voice-design",
   "scale-factor",
   "target-resolution"
 ];
@@ -69,13 +70,13 @@ var NEXRA_MEDIA_OPERATION_DEFINITIONS = Object.freeze([
     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", "generate_audio", "output_format", "seed"]
+    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"],
+    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"]
   },
   {
@@ -148,6 +149,7 @@ function inputSchema(contentItems, properties, contentBounds = {}) {
   };
 }
 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 = {
@@ -172,14 +174,17 @@ var NEXRA_MEDIA_INPUT_SCHEMAS = Object.freeze({
     }
   ),
   "video.generate": inputSchema(
-    [textPartSchema(["prompt", "negative_prompt", "script"]), imagePart, videoPart, audioPart, draftPart],
+    [textPartSchema(["prompt", "negative_prompt", "script"]), videoImagePart, videoPart, audioPart, draftPart],
     {
       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" } }
@@ -333,6 +338,10 @@ function isTerminalTaskStatus(status) {
   return status === "succeeded" || status === "failed" || status === "cancelled";
 }
 
+// ../contracts/src/admin-errors.ts
+var CALL_ERROR_STATUSES = ["failed", "rejected", "delivery_failed"];
+var CALL_ANOMALY_STATUSES = [...CALL_ERROR_STATUSES, "cancelled"];
+
 // ../contracts/src/ratio-display-order.ts
 function parseRatioParts(value) {
   const matched = /^\s*(\d+(?:\.\d+)?)\s*:\s*(\d+(?:\.\d+)?)\s*$/.exec(value);

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { a as AssetImportRequest, b as AssetInput, A as AssetReference, c as AssetUploadOptions, M as MEDIA_KINDS, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-dUJMQNJD.js';
-import { H as HttpTransport, q as ModelSearchParams, T as TaskModelSummary, r as TaskModel, s as ModelSchema, t as NexraClientOptions } from './media-geometry-Bo6ukeIQ.js';
-export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, M as MediaGeometryField, g as MediaGeometryProjection, u as ModelCapabilitySummary, v as ModelDateVersion, w as ModelEndpointSummary, x as ModelModality, y as ModelResourceList, z as ModelResourceOption, h as NexraBillingCurrency, d as NexraCatalogRevision, c as NexraDisplayQuoteBatch, A as NexraDisplayQuoteBatchEntry, j as NexraModelOperation, e as NexraModelSpec, f as NexraModelSpecFilter, a as NexraQuote, k as NexraSalePrice, N as NexraSalePriceList, l as NexraSettlement, U as UnifiedMediaGeometry, m as applyMediaGeometry, n as decodeMediaGeometry, o as encodeMediaGeometry, p as projectMediaGeometry } from './media-geometry-Bo6ukeIQ.js';
+import { H as HttpTransport, q as ModelSearchParams, T as TaskModelSummary, r as TaskModel, s as ModelSchema, t as NexraClientOptions } from './media-geometry-CRCAkREf.js';
+export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, M as MediaGeometryField, g as MediaGeometryProjection, u as ModelCapabilitySummary, v as ModelDateVersion, w as ModelEndpointSummary, x as ModelModality, y as ModelResourceList, z as ModelResourceOption, h as NexraBillingCurrency, d as NexraCatalogRevision, c as NexraDisplayQuoteBatch, A as NexraDisplayQuoteBatchEntry, j as NexraModelOperation, e as NexraModelSpec, f as NexraModelSpecFilter, a as NexraQuote, k as NexraSalePrice, N as NexraSalePriceList, l as NexraSettlement, U as UnifiedMediaGeometry, m as applyMediaGeometry, n as decodeMediaGeometry, o as encodeMediaGeometry, p as projectMediaGeometry } from './media-geometry-CRCAkREf.js';
 import { C as CursorPage, a as JsonValue } from './json-Drjj1OKl.js';
 export { J as JsonObject, b as JsonPrimitive } from './json-Drjj1OKl.js';
-import { A as AssetsClient, T as TasksClient, R as RunTaskOptions, a as RunResult, b as ApiErrorPayload, c as TaskResult } from './types-DPLgTh8D.js';
-export { C as CreateTaskOptions, d as CreateTaskRequest, e as RequestDetails, f as TASK_STATUSES, g 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, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, V as VerifyWebhookOptions, W as WaitTaskOptions, u as WatchTaskOptions, v as isTerminalTaskStatus, w as verifyWebhook } from './types-DPLgTh8D.js';
+import { A as AssetsClient, T as TasksClient, R as RunTaskOptions, a as RunResult, b as ApiErrorPayload, c as TaskResult } from './types-CmZz1KmL.js';
+export { C as CreateTaskOptions, d as CreateTaskRequest, e as RequestDetails, f as TASK_STATUSES, g 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, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, V as VerifyWebhookOptions, W as WaitTaskOptions, u as WatchTaskOptions, v as isTerminalTaskStatus, w as verifyWebhook } from './types-CmZz1KmL.js';
 import { CatalogClient } from './catalog.js';
 export { getModelSpec, listModelSpecs } from './catalog.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-7V2P2UQD.js";
+} from "./chunk-73CGYVFV.js";
 import {
   ceilDecimal,
   multiplyDecimal
@@ -24,7 +24,7 @@ import {
   TASK_STATUSES,
   createTaskRequest,
   isTerminalTaskStatus
-} from "./chunk-TA3YGQQY.js";
+} from "./chunk-KEAAHI25.js";
 
 // src/assets.ts
 var AssetsClient = class {

package/dist/{media-geometry-Bo6ukeIQ.d.ts → media-geometry-CRCAkREf.d.ts}

@@ -35,6 +35,7 @@ type ModelHttpOperation = Readonly<{
     kind: "request" | "create" | "query" | "cancel" | "delete" | "stream" | "generate" | "edit";
     httpMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
     pathTemplate: string;
+    documentationUrl?: string;
     schemaProjection: "request" | "bearer-request" | "managed-task-create" | "managed-task-query" | "managed-task-cancel" | "native-task-create" | "native-task-query" | "native-task-delete";
     responseStatus?: number;
     idempotencyKey?: boolean;

package/dist/media.d.ts

@@ -9,7 +9,7 @@ declare const NEXRA_MEDIA_OPERATIONS: readonly ["image.generate", "video.generat
 type NexraMediaOperation = (typeof NEXRA_MEDIA_OPERATIONS)[number];
 declare const NEXRA_PUBLISHED_MEDIA_OPERATIONS: readonly ["image.generate", "video.generate", "audio.generate", "image.upscale"];
 type NexraPublishedMediaOperation = (typeof NEXRA_PUBLISHED_MEDIA_OPERATIONS)[number];
-declare const NEXRA_MEDIA_FEATURES: readonly ["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", "scale-factor", "target-resolution"];
+declare const NEXRA_MEDIA_FEATURES: readonly ["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"];
 type NexraMediaFeature = (typeof NEXRA_MEDIA_FEATURES)[number];
 /** JSON wire locator. SDK-only Blob/File support is normalized into one of these forms. */
 type NexraMediaSource = string | AssetReference;
@@ -29,6 +29,14 @@ type NexraImageContentPart = Readonly<{
     /** Stable prompt reference name for models that address media as `@name`. */
     name?: string;
 }>;
+/** An image pinned inside a generated video; only models declaring this role accept it. */
+type NexraVideoKeyframeContentPart = Readonly<{
+    type: "image";
+    source: NexraMediaSource;
+    role: "keyframe";
+    /** Position in seconds, strictly inside the generated clip. */
+    timestamp: number;
+}>;
 type NexraVideoContentPart = Readonly<{
     type: "video";
     source: NexraMediaSource;
@@ -56,14 +64,18 @@ type NexraImageGenerateInput = Readonly<{
     seed?: number;
 }>;
 type NexraVideoGenerateInput = Readonly<{
-    content: readonly (NexraMediaContentPart | NexraDraftContentPart)[];
+    content: readonly (NexraMediaContentPart | NexraDraftContentPart | NexraVideoKeyframeContentPart)[];
     draft?: boolean;
+    /** Explicit no-watermark value, only on models whose contract declares it. */
+    watermark?: false;
     /** Optional preset or cloned voice used by talking-avatar video models. */
     voice?: string;
     aspect_ratio?: string;
     resolution?: string;
     quality?: string;
     duration?: number;
+    fit?: "contain" | "cover";
+    title?: string;
     generate_audio?: boolean;
     output_format?: string;
     seed?: number;
@@ -170,12 +182,12 @@ declare const NEXRA_MEDIA_OPERATION_DEFINITIONS: readonly [{
     readonly status: "active";
     readonly outputKind: "video";
     readonly features: readonly ["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"];
-    readonly parameterKeys: readonly ["voice", "aspect_ratio", "resolution", "quality", "duration", "generate_audio", "output_format", "seed"];
+    readonly parameterKeys: readonly ["voice", "aspect_ratio", "resolution", "quality", "duration", "fit", "title", "generate_audio", "output_format", "seed", "watermark"];
 }, {
     readonly operation: "audio.generate";
     readonly status: "active";
     readonly outputKind: "audio";
-    readonly features: readonly ["tts", "music", "sfx", "voice-reference"];
+    readonly features: readonly ["tts", "music", "sfx", "voice-reference", "voice-design"];
     readonly parameterKeys: readonly ["voice", "language", "duration", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion", "instrumental", "loop", "prompt_influence", "seed"];
 }, {
     readonly operation: "image.upscale";
@@ -197,4 +209,4 @@ declare function nexraMediaOperationForMode(mode: string): NexraPublishedMediaOp
 /** Narrow the shared category vocabulary for one Experience Center input mode. */
 declare function nexraMediaInputSchemaForMode(mode: string): JsonObject | undefined;
 
-export { NEXRA_GENERATION_OPERATIONS, NEXRA_MEDIA_API_VERSION, NEXRA_MEDIA_FEATURES, NEXRA_MEDIA_INPUT_SCHEMAS, NEXRA_MEDIA_OPERATIONS, NEXRA_MEDIA_OPERATION_DEFINITIONS, NEXRA_PUBLISHED_MEDIA_OPERATIONS, type NexraAudioContentPart, type NexraAudioGenerateInput, type NexraGenerationOperation, type NexraImageContentPart, type NexraImageGenerateInput, type NexraImageUpscaleInput, type NexraMediaContentPart, type NexraMediaFeature, type NexraMediaInputByOperation, type NexraMediaInputMode, type NexraMediaInputSlot, type NexraMediaKind, type NexraMediaOperation, type NexraMediaOperationDefinition, type NexraMediaParameter, type NexraMediaParameterConstraint, type NexraMediaSource, type NexraPublishedMediaOperation, type NexraTextContentPart, type NexraVideoContentPart, type NexraVideoGenerateInput, type NexraVideoUpscaleInput, isNexraMediaInput, nexraMediaInputSchema, nexraMediaInputSchemaForMode, nexraMediaOperationForMode };
+export { NEXRA_GENERATION_OPERATIONS, NEXRA_MEDIA_API_VERSION, NEXRA_MEDIA_FEATURES, NEXRA_MEDIA_INPUT_SCHEMAS, NEXRA_MEDIA_OPERATIONS, NEXRA_MEDIA_OPERATION_DEFINITIONS, NEXRA_PUBLISHED_MEDIA_OPERATIONS, type NexraAudioContentPart, type NexraAudioGenerateInput, type NexraGenerationOperation, type NexraImageContentPart, type NexraImageGenerateInput, type NexraImageUpscaleInput, type NexraMediaContentPart, type NexraMediaFeature, type NexraMediaInputByOperation, type NexraMediaInputMode, type NexraMediaInputSlot, type NexraMediaKind, type NexraMediaOperation, type NexraMediaOperationDefinition, type NexraMediaParameter, type NexraMediaParameterConstraint, type NexraMediaSource, type NexraPublishedMediaOperation, type NexraTextContentPart, type NexraVideoContentPart, type NexraVideoGenerateInput, type NexraVideoKeyframeContentPart, type NexraVideoUpscaleInput, isNexraMediaInput, nexraMediaInputSchema, nexraMediaInputSchemaForMode, nexraMediaOperationForMode };

package/dist/media.js

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

package/dist/{types-DPLgTh8D.d.ts → types-CmZz1KmL.d.ts}

@@ -1,5 +1,5 @@
 import { d as MediaAsset, c as AssetUploadOptions, a as AssetImportRequest, g as AssetCertificationRequest, h as AssetCertification, i as AssetCertificationWaitOptions } from './assets-dUJMQNJD.js';
-import { l as NexraSettlement, H as HttpTransport } from './media-geometry-Bo6ukeIQ.js';
+import { l as NexraSettlement, H as HttpTransport } from './media-geometry-CRCAkREf.js';
 import { J as JsonObject, a as JsonValue, C as CursorPage } from './json-Drjj1OKl.js';
 
 interface ApiErrorPayload {
@@ -40,6 +40,12 @@ interface TaskCost {
     amount: string;
     currency: string;
 }
+interface TaskQueueSnapshot {
+    phase: "waiting_capacity" | "waiting_channel" | "dispatch_pending";
+    since: string;
+    deadlineAt?: string;
+    cancelable: boolean;
+}
 interface TaskTiming {
     submittedAt: string;
     providerSubmittedAt?: string;
@@ -77,6 +83,8 @@ interface Task<TOutput = JsonValue> {
     /** Model request parameters; native-managed tasks retain the upstream field structure. */
     input?: JsonObject;
     status: TaskStatus;
+    /** Present only while an asynchronous Task is queued. */
+    queue?: TaskQueueSnapshot;
     /** Persistence policy frozen when the Task is created. Background is limited to video Tasks. */
     persistPolicy?: "terminal" | "background";
     /**
@@ -126,7 +134,7 @@ interface Task<TOutput = JsonValue> {
 /** POST /tasks returns acceptance only, including for idempotent replays. */
 type TaskReceipt = Pick<Task, "id" | "status">;
 /** Public Task result; platform diagnostics and business tags live in RequestDetails. */
-type TaskResult<TOutput = JsonValue> = Pick<Task<TOutput>, "id" | "model" | "status"> & Partial<Pick<Task<TOutput>, "requestId" | "output" | "assets" | "error" | "persistPolicy" | "deliveryStatus" | "settlement">>;
+type TaskResult<TOutput = JsonValue> = Pick<Task<TOutput>, "id" | "model" | "status"> & Partial<Pick<Task<TOutput>, "requestId" | "output" | "assets" | "error" | "persistPolicy" | "deliveryStatus" | "settlement" | "queue">>;
 /** Platform request details, used by both managed Tasks and native proxy requests. */
 interface RequestDetails {
     id: string;

package/dist/types.d.ts

@@ -1,4 +1,4 @@
 export { a as AssetImportRequest, b as AssetInput, A as AssetReference, c as AssetUploadOptions, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-dUJMQNJD.js';
-export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, M as MediaGeometryField, g as MediaGeometryProjection, u as ModelCapabilitySummary, v as ModelDateVersion, w as ModelEndpointSummary, x as ModelModality, y as ModelResourceList, z as ModelResourceOption, s as ModelSchema, q as ModelSearchParams, h as NexraBillingCurrency, d as NexraCatalogRevision, t as NexraClientOptions, c as NexraDisplayQuoteBatch, A as NexraDisplayQuoteBatchEntry, j as NexraModelOperation, e as NexraModelSpec, f as NexraModelSpecFilter, a as NexraQuote, k as NexraSalePrice, N as NexraSalePriceList, l as NexraSettlement, r as TaskModel, T as TaskModelSummary, U as UnifiedMediaGeometry } from './media-geometry-Bo6ukeIQ.js';
+export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, M as MediaGeometryField, g as MediaGeometryProjection, u as ModelCapabilitySummary, v as ModelDateVersion, w as ModelEndpointSummary, x as ModelModality, y as ModelResourceList, z as ModelResourceOption, s as ModelSchema, q as ModelSearchParams, h as NexraBillingCurrency, d as NexraCatalogRevision, t as NexraClientOptions, c as NexraDisplayQuoteBatch, A as NexraDisplayQuoteBatchEntry, j as NexraModelOperation, e as NexraModelSpec, f as NexraModelSpecFilter, a as NexraQuote, k as NexraSalePrice, N as NexraSalePriceList, l as NexraSettlement, r as TaskModel, T as TaskModelSummary, U as UnifiedMediaGeometry } from './media-geometry-CRCAkREf.js';
 export { C as CursorPage, J as JsonObject, b as JsonPrimitive, a as JsonValue } from './json-Drjj1OKl.js';
-export { b as ApiErrorPayload, C as CreateTaskOptions, d as CreateTaskRequest, e as RequestDetails, a as RunResult, R as RunTaskOptions, g 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, V as VerifyWebhookOptions, W as WaitTaskOptions, u as WatchTaskOptions } from './types-DPLgTh8D.js';
+export { b as ApiErrorPayload, C as CreateTaskOptions, d as CreateTaskRequest, e as RequestDetails, a as RunResult, R as RunTaskOptions, g 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, V as VerifyWebhookOptions, W as WaitTaskOptions, u as WatchTaskOptions } from './types-CmZz1KmL.js';

package/package.json

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