@byte_fluffy/nexra-sdk 0.1.0-alpha.20 → 0.1.0-alpha.21

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-import { A as AssetsClient, T as TasksClient, R as RunTaskOptions, a as RunResult, b as ApiErrorPayload, c as TaskResult } from './types-CvKdgo7V.js';
-export { d as AssetImportRequest, e as AssetInput, f as AssetReference, g as AssetUploadOptions, C as CreateTaskOptions, h as CreateTaskRequest, M as MEDIA_KINDS, i as MediaAsset, j as MediaAssetStatus, k as MediaKind, l as RequestDetails, m as TASK_STATUSES, n as Task, o as TaskCost, p as TaskError, q as TaskEvent, r as TaskEventType, s as TaskListParams, t as TaskPage, u as TaskProgress, v as TaskReceipt, w as TaskStatus, x as TaskTiming, y as TaskUsage, z as TaskWebhookConfig, B as TerminalTaskStatus, V as VerifyWebhookOptions, W as WaitTaskOptions, D as WatchTaskOptions, E as isTerminalTaskStatus, F as verifyWebhook } from './types-CvKdgo7V.js';
-import { H as HttpTransport, q as ModelSearchParams, r as CursorPage, T as TaskModelSummary, s as TaskModel, t as ModelSchema, u as NexraClientOptions, J as JsonValue } from './media-geometry-Ckr1-Mh3.js';
-export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, v as JsonObject, w as JsonPrimitive, M as MediaGeometryField, g as MediaGeometryProjection, x as ModelCapabilitySummary, y as ModelDateVersion, z as ModelEndpointSummary, A as ModelModality, B as ModelResourceList, D as ModelResourceOption, h as NexraBillingCurrency, d as NexraCatalogRevision, c as NexraDisplayQuoteBatch, E 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-Ckr1-Mh3.js';
+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 { 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 { CatalogClient } from './catalog.js';
 export { getModelSpec, listModelSpecs } from './catalog.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';
@@ -20,7 +23,7 @@ declare class NexraClient {
     readonly models: ModelsClient;
     readonly tasks: TasksClient;
     constructor(options?: NexraClientOptions);
-    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, options: RunTaskOptions<TInput>): Promise<RunResult<TOutput>>;
+    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: RunTaskOptions): Promise<RunResult<TOutput>>;
 }
 declare function createNexra(options?: NexraClientOptions): NexraClient;
 

package/dist/index.js

@@ -1,27 +1,30 @@
 import {
   CatalogClient,
   HttpTransport,
-  MEDIA_KINDS,
   NexraApiError,
   NexraTaskError,
   NexraWaitTimeoutError,
-  TASK_STATUSES,
   applyMediaGeometry,
   applyNoWatermark,
   decodeMediaGeometry,
   encodeMediaGeometry,
   getModelSpec,
-  isTerminalTaskStatus,
   jsonBody,
   listModelSpecs,
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-PAVF5LNU.js";
+} from "./chunk-WU62FGYW.js";
 import {
   ceilDecimal,
   multiplyDecimal
 } from "./chunk-FCH5IQP5.js";
+import {
+  MEDIA_KINDS,
+  TASK_STATUSES,
+  createTaskRequest,
+  isTerminalTaskStatus
+} from "./chunk-TA3YGQQY.js";
 
 // src/assets.ts
 var AssetsClient = class {
@@ -279,20 +282,18 @@ var TasksClient = class {
   }
   transport;
   assets;
-  async create(model, options) {
+  async create(model, input, options = {}) {
     const schema = getModelSpec(model)?.operations[0]?.inputSchema;
-    const mapped = schema && options.input && typeof options.input === "object" && !Array.isArray(options.input) ? applyNoWatermark(schema, applyMediaGeometry(schema, options.input)) : options.input;
-    const input = await normalizeTaskInput(mapped, this.assets, options.signal);
-    const body = {
-      model,
-      input,
+    const mapped = schema && input && typeof input === "object" && !Array.isArray(input) ? applyNoWatermark(schema, applyMediaGeometry(schema, input)) : input;
+    const normalizedInput = await normalizeTaskInput(mapped, this.assets, options.signal);
+    const body = createTaskRequest(model, normalizedInput, {
       quoteToken: options.quoteToken,
       submittedAt: options.submittedAt,
       metadata: options.metadata,
       callback_url: options.callback_url,
       webhook: options.webhook,
       schemaVersion: options.schemaVersion
-    };
+    });
     const idempotencyKey = options.idempotencyKey ?? crypto.randomUUID();
     return this.transport.json(
       "/tasks",
@@ -398,8 +399,8 @@ var TasksClient = class {
       if (timeout) clearTimeout(timeout);
     }
   }
-  async run(model, options) {
-    const task = await this.create(model, options);
+  async run(model, input, options = {}) {
+    const task = await this.create(model, input, options);
     let completed;
     try {
       completed = await this.wait(task.id, options);
@@ -440,8 +441,8 @@ var NexraClient = class {
     this.models = new ModelsClient(transport);
     this.tasks = new TasksClient(transport, this.assets);
   }
-  run(model, options) {
-    return this.tasks.run(model, options);
+  run(model, input, options = {}) {
+    return this.tasks.run(model, input, options);
   }
 };
 function createNexra(options = {}) {

package/dist/json-Drjj1OKl.d.ts

@@ -0,0 +1,11 @@
+type JsonPrimitive = boolean | number | string | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+    [key: string]: JsonValue;
+}
+interface CursorPage<T> {
+    data: T[];
+    nextCursor?: string;
+}
+
+export type { CursorPage as C, JsonObject as J, JsonValue as a, JsonPrimitive as b };

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

@@ -1,12 +1,4 @@
-type JsonPrimitive = boolean | number | string | null;
-type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
-interface JsonObject {
-    [key: string]: JsonValue;
-}
-interface CursorPage<T> {
-    data: T[];
-    nextCursor?: string;
-}
+import { b as JsonPrimitive, J as JsonObject, a as JsonValue } from './json-Drjj1OKl.js';
 
 declare const BILLING_METRICS: readonly ["requests", "input_tokens", "cached_input_tokens", "cache_write_tokens", "cache_creation_5m_input_tokens", "cache_creation_1h_input_tokens", "cache_read_input_tokens", "output_tokens", "input_characters", "input_utf8_bytes", "input_images", "output_images", "input_audio_seconds", "output_audio_seconds", "input_video_seconds", "output_video_seconds", "provider_credits", "web_search_requests"];
 type BillingMetric = (typeof BILLING_METRICS)[number];
@@ -37,6 +29,27 @@ interface MeteringContract {
 }
 
 type ModelModality = "language" | "embedding" | "reranker" | "image" | "video" | "audio" | "world" | "multimodal" | "other";
+/** A concrete operation of a code-owned endpoint contract, shared by API and UI. */
+type ModelHttpOperation = Readonly<{
+    key: string;
+    kind: "request" | "create" | "query" | "cancel" | "delete" | "stream" | "generate" | "edit";
+    httpMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    pathTemplate: 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;
+    queryParameters?: Readonly<JsonObject>;
+    headerParameters?: Readonly<JsonObject>;
+    pathParameters?: Readonly<JsonObject>;
+    /** Operation-specific body; binary fields describe multipart file parts. */
+    bodyParameters?: Readonly<JsonObject>;
+    responseBody?: Readonly<JsonObject>;
+    requestBody?: Readonly<{
+        properties: readonly string[];
+        required: readonly string[];
+        oneOfRequired?: readonly (readonly string[])[];
+    }>;
+}>;
 interface ModelEndpointSummary {
     key: string;
     label: string;
@@ -47,6 +60,8 @@ interface ModelEndpointSummary {
     capabilities: string[];
     /** Task execution of this native endpoint, not a second model parameter definition. */
     sourceEndpointKey?: string | null;
+    documentationUrl?: string;
+    httpOperations?: readonly ModelHttpOperation[];
 }
 interface ModelCapabilitySummary {
     inputModalities: string[];
@@ -118,6 +133,8 @@ interface TaskModel extends TaskModelSummary {
 interface ModelSchema {
     model: string;
     version: number;
+    /** Contract owner for the returned schema. Defaults to nexra for older servers. */
+    contract?: "nexra" | "native";
     dialect: "https://json-schema.org/draft/2020-12/schema" | string;
     inputSchema: JsonObject;
     outputSchema: JsonObject;
@@ -284,7 +301,7 @@ declare class HttpTransport {
     response(path: string, init?: RequestInit, options?: RequestOptions): Promise<Response>;
 }
 
-/** Unified canvas vocabulary: resolution 1K/2K/4K, ratio X:X. */
+/** UI-friendly view of Nexra's canonical geometry fields. */
 type UnifiedMediaGeometry = {
     resolution?: string;
     ratio?: string;
@@ -292,27 +309,23 @@ type UnifiedMediaGeometry = {
 };
 type MediaGeometryField = {
     field: string;
-    nest?: string;
     options: readonly string[];
     default?: string;
     optionLabels: Readonly<Record<string, string>>;
 };
 type MediaGeometryProjection = {
-    kind: "pixel-size" | "tier-size" | "resolution-ratio" | "ratio-only" | "none";
+    kind: "resolution-ratio" | "ratio-only" | "none";
     resolution?: MediaGeometryField;
     ratio?: MediaGeometryField;
     quality?: MediaGeometryField;
 };
-/** Schema → unified resolution/ratio/quality controls for app UIs. */
+/** Read controls from the Nexra contract. It never exposes provider-native size fields. */
 declare function projectMediaGeometry(inputSchema: JsonObject): MediaGeometryProjection;
-/** Unified geometry → the model's native catalog fields (channel original params). */
+/** UI geometry aliases → canonical Nexra request fields. */
 declare function encodeMediaGeometry(inputSchema: JsonObject, geometry: UnifiedMediaGeometry): JsonObject;
-/** Native catalog fields → unified resolution/ratio/quality. */
-declare function decodeMediaGeometry(inputSchema: JsonObject, nativeInput: JsonObject): UnifiedMediaGeometry;
-/**
- * Rewrite a Task/quote body: unified keys become native catalog fields.
- * Native size/ratio already present is left alone (existing callers keep working).
- */
+/** Canonical Nexra request fields → UI geometry aliases. */
+declare function decodeMediaGeometry(_inputSchema: JsonObject, input: JsonObject): UnifiedMediaGeometry;
+/** Normalize the SDK convenience alias `ratio` without producing Native fields. */
 declare function applyMediaGeometry(inputSchema: JsonObject, input: JsonObject): JsonObject;
 
-export { type ModelModality as A, type ModelResourceList as B, type CreateNexraQuoteRequest as C, type ModelResourceOption as D, type NexraDisplayQuoteBatchEntry as E, type FetchLike as F, HttpTransport as H, type JsonValue as J, type MediaGeometryField as M, type NexraSalePriceList as N, type TaskModelSummary as T, type UnifiedMediaGeometry as U, type NexraQuote as a, type CreateNexraDisplayQuoteBatchRequest as b, type NexraDisplayQuoteBatch as c, type NexraCatalogRevision as d, type NexraModelSpec as e, type NexraModelSpecFilter as f, type MediaGeometryProjection as g, type NexraBillingCurrency as h, type NexraModelEndpointSpec as i, type NexraModelOperation as j, type NexraSalePrice as k, type NexraSettlement as l, applyMediaGeometry as m, decodeMediaGeometry as n, encodeMediaGeometry as o, projectMediaGeometry as p, type ModelSearchParams as q, type CursorPage as r, type TaskModel as s, type ModelSchema as t, type NexraClientOptions as u, type JsonObject as v, type JsonPrimitive as w, type ModelCapabilitySummary as x, type ModelDateVersion as y, type ModelEndpointSummary as z };
+export { type NexraDisplayQuoteBatchEntry as A, type CreateNexraQuoteRequest as C, type FetchLike as F, HttpTransport as H, type MediaGeometryField as M, type NexraSalePriceList as N, type TaskModelSummary as T, type UnifiedMediaGeometry as U, type NexraQuote as a, type CreateNexraDisplayQuoteBatchRequest as b, type NexraDisplayQuoteBatch as c, type NexraCatalogRevision as d, type NexraModelSpec as e, type NexraModelSpecFilter as f, type MediaGeometryProjection as g, type NexraBillingCurrency as h, type NexraModelEndpointSpec as i, type NexraModelOperation as j, type NexraSalePrice as k, type NexraSettlement as l, applyMediaGeometry as m, decodeMediaGeometry as n, encodeMediaGeometry as o, projectMediaGeometry as p, type ModelSearchParams as q, type TaskModel as r, type ModelSchema as s, type NexraClientOptions as t, type ModelCapabilitySummary as u, type ModelDateVersion as v, type ModelEndpointSummary as w, type ModelModality as x, type ModelResourceList as y, type ModelResourceOption as z };

package/dist/media.d.ts

@@ -0,0 +1,200 @@
+import { A as AssetReference } from './assets-dUJMQNJD.js';
+import { J as JsonObject } from './json-Drjj1OKl.js';
+
+declare const NEXRA_MEDIA_API_VERSION: 1;
+/** Catalog-level generation taxonomy. Text keeps its native endpoint protocols. */
+declare const NEXRA_GENERATION_OPERATIONS: readonly ["text.generate", "image.generate", "video.generate", "audio.generate", "image.upscale", "video.upscale"];
+type NexraGenerationOperation = (typeof NEXRA_GENERATION_OPERATIONS)[number];
+declare const NEXRA_MEDIA_OPERATIONS: readonly ["image.generate", "video.generate", "audio.generate", "image.upscale", "video.upscale"];
+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"];
+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;
+type NexraTextRole = "prompt" | "negative_prompt" | "script" | "lyrics";
+type NexraImageRole = "source" | "reference" | "first_frame" | "last_frame" | "mask" | "control" | "subject" | "background";
+type NexraVideoRole = "source" | "reference" | "edit" | "extend";
+type NexraAudioRole = "source" | "reference" | "voice_reference";
+type NexraTextContentPart = Readonly<{
+    type: "text";
+    text: string;
+    role?: NexraTextRole;
+}>;
+type NexraImageContentPart = Readonly<{
+    type: "image";
+    source: NexraMediaSource;
+    role?: NexraImageRole;
+    /** Stable prompt reference name for models that address media as `@name`. */
+    name?: string;
+}>;
+type NexraVideoContentPart = Readonly<{
+    type: "video";
+    source: NexraMediaSource;
+    role?: NexraVideoRole;
+}>;
+type NexraAudioContentPart = Readonly<{
+    type: "audio";
+    source: NexraMediaSource;
+    role?: NexraAudioRole;
+}>;
+type NexraMediaContentPart = NexraTextContentPart | NexraImageContentPart | NexraVideoContentPart | NexraAudioContentPart;
+type NexraDraftContentPart = Readonly<{
+    type: "draft_task";
+    draft_task: Readonly<{
+        id: string;
+    }>;
+}>;
+type NexraImageGenerateInput = Readonly<{
+    content: readonly (NexraTextContentPart | NexraImageContentPart)[];
+    aspect_ratio?: string;
+    resolution?: string;
+    quality?: string;
+    count?: number;
+    output_format?: string;
+    seed?: number;
+}>;
+type NexraVideoGenerateInput = Readonly<{
+    content: readonly (NexraMediaContentPart | NexraDraftContentPart)[];
+    draft?: boolean;
+    /** Optional preset or cloned voice used by talking-avatar video models. */
+    voice?: string;
+    aspect_ratio?: string;
+    resolution?: string;
+    quality?: string;
+    duration?: number;
+    generate_audio?: boolean;
+    output_format?: string;
+    seed?: number;
+}>;
+type NexraAudioGenerateInput = Readonly<{
+    content: readonly (NexraTextContentPart | NexraAudioContentPart)[];
+    voice?: string;
+    language?: string;
+    duration?: number;
+    output_format?: string;
+    sample_rate?: number;
+    speed?: number;
+    volume?: number;
+    pitch?: number;
+    emotion?: string;
+    instrumental?: boolean;
+    loop?: boolean;
+    prompt_influence?: number;
+    seed?: number;
+}>;
+type NexraImageUpscaleInput = Readonly<{
+    content: readonly [NexraImageContentPart];
+    scale?: number;
+    resolution?: string;
+    output_format?: string;
+    preserve_details?: boolean;
+}>;
+type NexraVideoUpscaleInput = Readonly<{
+    content: readonly [NexraVideoContentPart];
+    scale?: number;
+    resolution?: string;
+    output_format?: string;
+    preserve_details?: boolean;
+}>;
+type NexraMediaInputByOperation = Readonly<{
+    "image.generate": NexraImageGenerateInput;
+    "video.generate": NexraVideoGenerateInput;
+    "audio.generate": NexraAudioGenerateInput;
+    "image.upscale": NexraImageUpscaleInput;
+    "video.upscale": NexraVideoUpscaleInput;
+}>;
+type NexraMediaKind = "image" | "video" | "audio";
+type NexraMediaInputSlot = Readonly<{
+    mediaKind: NexraMediaKind;
+    role: string;
+    min?: number;
+    max: number;
+    maxBytes?: number;
+    minDurationSeconds?: number;
+    maxDurationSeconds?: number;
+}>;
+type NexraMediaInputMode = Readonly<{
+    id: string;
+    slots: readonly NexraMediaInputSlot[];
+}>;
+type NexraMediaParameterValue = string | number | boolean;
+type NexraMediaParameter = Readonly<{
+    key: string;
+    label?: string;
+}> & (Readonly<{
+    kind: "enum";
+    options: readonly NexraMediaParameterValue[];
+    default: NexraMediaParameterValue;
+    allowCustom?: boolean;
+}> | Readonly<{
+    kind: "range";
+    min: number;
+    max: number;
+    step: number;
+    default: number;
+    autoValue?: number;
+    unit?: string;
+}> | Readonly<{
+    kind: "toggle";
+    default: boolean;
+}> | Readonly<{
+    kind: "resource";
+    resource: "voice";
+    default?: string;
+    allowCustom?: boolean;
+}>);
+type NexraMediaParameterConstraint = Readonly<{
+    when: Readonly<Record<string, NexraMediaParameterValue | readonly NexraMediaParameterValue[]>>;
+    parameter: string;
+    allowedValues?: readonly NexraMediaParameterValue[];
+    fixedValue?: NexraMediaParameterValue;
+    disabled?: boolean;
+}>;
+type NexraMediaOperationDefinition = Readonly<{
+    operation: NexraMediaOperation;
+    status: "active" | "hold";
+    outputKind: NexraMediaKind;
+    features: readonly NexraMediaFeature[];
+    parameterKeys: readonly string[];
+}>;
+declare const NEXRA_MEDIA_OPERATION_DEFINITIONS: readonly [{
+    readonly operation: "image.generate";
+    readonly status: "active";
+    readonly outputKind: "image";
+    readonly features: readonly ["text-to-image", "image-to-image", "image-reference", "image-edit", "image-inpaint", "image-control"];
+    readonly parameterKeys: readonly ["aspect_ratio", "resolution", "quality", "count", "output_format", "seed"];
+}, {
+    readonly operation: "video.generate";
+    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 operation: "audio.generate";
+    readonly status: "active";
+    readonly outputKind: "audio";
+    readonly features: readonly ["tts", "music", "sfx", "voice-reference"];
+    readonly parameterKeys: readonly ["voice", "language", "duration", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion", "instrumental", "loop", "prompt_influence", "seed"];
+}, {
+    readonly operation: "image.upscale";
+    readonly status: "active";
+    readonly outputKind: "image";
+    readonly features: readonly ["scale-factor", "target-resolution"];
+    readonly parameterKeys: readonly ["scale", "resolution", "output_format", "preserve_details"];
+}, {
+    readonly operation: "video.upscale";
+    readonly status: "hold";
+    readonly outputKind: "video";
+    readonly features: readonly ["scale-factor", "target-resolution"];
+    readonly parameterKeys: readonly ["scale", "resolution", "output_format", "preserve_details"];
+}];
+declare const NEXRA_MEDIA_INPUT_SCHEMAS: Readonly<Record<NexraPublishedMediaOperation, JsonObject>>;
+declare function nexraMediaInputSchema(operation: NexraMediaOperation): JsonObject | undefined;
+declare function isNexraMediaInput(value: unknown): value is JsonObject;
+declare function nexraMediaOperationForMode(mode: string): NexraPublishedMediaOperation | undefined;
+/** 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 };

package/dist/media.js

@@ -0,0 +1,26 @@
+import {
+  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,
+  isNexraMediaInput,
+  nexraMediaInputSchema,
+  nexraMediaInputSchemaForMode,
+  nexraMediaOperationForMode
+} from "./chunk-TA3YGQQY.js";
+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,
+  isNexraMediaInput,
+  nexraMediaInputSchema,
+  nexraMediaInputSchemaForMode,
+  nexraMediaOperationForMode
+};

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

@@ -1,62 +1,6 @@
-import { v as JsonObject, J as JsonValue, l as NexraSettlement, r as CursorPage, H as HttpTransport } from './media-geometry-Ckr1-Mh3.js';
-
-declare const MEDIA_KINDS: readonly ["image", "video", "audio", "document", "archive", "other"];
-type MediaKind = (typeof MEDIA_KINDS)[number];
-type MediaAssetStatus = "pending" | "ready" | "failed" | "deleted";
-interface MediaAsset {
-    id: string;
-    kind: MediaKind;
-    status: MediaAssetStatus;
-    source: "upload" | "generated" | "provider" | "imported";
-    name?: string;
-    mimeType?: string;
-    sizeBytes?: number;
-    width?: number;
-    height?: number;
-    durationMs?: number;
-    checksumSha256?: string;
-    url?: string;
-    downloadUrl?: string;
-    expiresAt?: string;
-    metadata?: JsonObject;
-    createdAt: string;
-}
-interface AssetReference {
-    assetId: string;
-}
-type AssetInput = AssetReference | Blob | File | MediaAsset | string | URL;
-interface AssetUploadOptions {
-    kind?: MediaKind;
-    name?: string;
-    signal?: AbortSignal;
-}
-interface AssetImportRequest {
-    url: string;
-    kind?: MediaKind;
-    name?: string;
-}
-type AssetCertificationProvider = "seedance";
-type AssetCertificationStatus = "processing" | "ready" | "failed";
-interface AssetCertification {
-    assetId: string;
-    provider: AssetCertificationProvider;
-    status: AssetCertificationStatus;
-    providerAssetId?: string;
-    assetUri?: string;
-    groupId?: string;
-    library: "general" | "liveness";
-    error?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface AssetCertificationRequest {
-    library?: "general" | "liveness";
-}
-interface AssetCertificationWaitOptions {
-    pollIntervalMs?: number;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
+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 { J as JsonObject, a as JsonValue, C as CursorPage } from './json-Drjj1OKl.js';
 
 interface ApiErrorPayload {
     error: {
@@ -243,17 +187,16 @@ interface TaskEvent {
     occurredAt: string;
 }
 /** @deprecated Use CreateTaskRequest.callback_url. Kept for existing callers. */
-interface TaskWebhookConfig {
+type TaskWebhookConfig = JsonObject & Readonly<{
     url: string;
     /** Shared HMAC secret used to verify Nexra callback signatures. */
     secret: string;
     events?: Array<"completed">;
-}
-interface CreateTaskRequest<TInput = Record<string, unknown>> {
+}>;
+type CreateTaskControls = Readonly<{
     /** @internal Console telemetry only: browser send time before uploads, not execution time. */
     submittedAt?: string;
     model: string;
-    input: TInput;
     /** Signed Nexra quote used to lock this input to a sale-price revision. */
     quoteToken?: string;
     /** Optional business identifiers such as orderId, available in request details. Do not include secrets. */
@@ -264,7 +207,11 @@ interface CreateTaskRequest<TInput = Record<string, unknown>> {
     webhook?: TaskWebhookConfig;
     /** @deprecated Compatibility check only; the server resolves the current contract. */
     schemaVersion?: number;
-}
+}>;
+/** Public Nexra Task request. Category parameters are top-level fields; `input`
+ * is deliberately not an envelope. Persistent Task records still retain their
+ * own `input` snapshot after the HTTP boundary separates control fields. */
+type CreateTaskRequest<TInput extends JsonObject = JsonObject> = TInput & CreateTaskControls;
 interface TaskListParams {
     status?: TaskStatus;
     model?: string;
@@ -295,8 +242,7 @@ declare class AssetsClient {
     stream(asset: MediaAsset | string, signal?: AbortSignal): Promise<ReadableStream<Uint8Array>>;
 }
 
-interface CreateTaskOptions<TInput = Record<string, unknown>> {
-    input: TInput;
+interface CreateTaskOptions {
     quoteToken?: string;
     submittedAt?: string;
     metadata?: JsonObject;
@@ -317,20 +263,20 @@ interface WaitTaskOptions extends WatchTaskOptions {
     pollIntervalMs?: number;
     onEvent?: (event: TaskEvent) => void | Promise<void>;
 }
-interface RunTaskOptions<TInput = Record<string, unknown>> extends CreateTaskOptions<TInput>, WaitTaskOptions {
+interface RunTaskOptions extends CreateTaskOptions, WaitTaskOptions {
     cancelOnAbort?: boolean;
 }
 declare class TasksClient {
     private readonly transport;
     private readonly assets;
     constructor(transport: HttpTransport, assets: AssetsClient);
-    create<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, options: CreateTaskOptions<TInput>): Promise<TaskReceipt>;
+    create<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: CreateTaskOptions): Promise<TaskReceipt>;
     get<TOutput = JsonValue>(taskId: string, signal?: AbortSignal): Promise<TaskResult<TOutput>>;
     list<TOutput = JsonValue>(params?: TaskListParams, signal?: AbortSignal): Promise<CursorPage<TaskResult<TOutput>>>;
     cancel<TOutput = JsonValue>(taskId: string, signal?: AbortSignal): Promise<TaskReceipt>;
     watch(taskId: string, options?: WatchTaskOptions): AsyncGenerator<TaskEvent>;
     wait<TOutput = JsonValue>(taskId: string, options?: WaitTaskOptions): Promise<TaskResult<TOutput>>;
-    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, options: RunTaskOptions<TInput>): Promise<RunResult<TOutput>>;
+    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: RunTaskOptions): Promise<RunResult<TOutput>>;
 }
 
 interface VerifyWebhookOptions {
@@ -340,4 +286,4 @@ interface VerifyWebhookOptions {
 /** @deprecated Only verifies legacy signed webhooks, not callback_url notifications. */
 declare function verifyWebhook(request: Request, secret: string, options?: VerifyWebhookOptions): Promise<boolean>;
 
-export { AssetsClient as A, type TerminalTaskStatus as B, type CreateTaskOptions as C, type WatchTaskOptions as D, isTerminalTaskStatus as E, verifyWebhook as F, MEDIA_KINDS as M, type RunTaskOptions as R, TasksClient as T, type VerifyWebhookOptions as V, type WaitTaskOptions as W, type RunResult as a, type ApiErrorPayload as b, type TaskResult as c, type AssetImportRequest as d, type AssetInput as e, type AssetReference as f, type AssetUploadOptions as g, type CreateTaskRequest as h, type MediaAsset as i, type MediaAssetStatus as j, type MediaKind as k, type RequestDetails as l, TASK_STATUSES as m, type Task as n, type TaskCost as o, type TaskError as p, type TaskEvent as q, type TaskEventType as r, type TaskListParams as s, type TaskPage as t, type TaskProgress as u, type TaskReceipt as v, type TaskStatus as w, type TaskTiming as x, type TaskUsage as y, type TaskWebhookConfig as z };
+export { AssetsClient as A, type CreateTaskOptions as C, type RunTaskOptions as R, TasksClient as T, type VerifyWebhookOptions as V, type WaitTaskOptions as W, type RunResult as a, type ApiErrorPayload as b, type TaskResult as c, type CreateTaskRequest as d, type RequestDetails as e, TASK_STATUSES as f, type Task as g, type TaskCost as h, type TaskError as i, type TaskEvent as j, type TaskEventType as k, type TaskListParams as l, type TaskPage as m, type TaskProgress as n, type TaskReceipt as o, type TaskStatus as p, type TaskTiming as q, type TaskUsage as r, type TaskWebhookConfig as s, type TerminalTaskStatus as t, type WatchTaskOptions as u, isTerminalTaskStatus as v, verifyWebhook as w };

package/dist/types.d.ts

@@ -1,2 +1,4 @@
-export { b as ApiErrorPayload, d as AssetImportRequest, e as AssetInput, f as AssetReference, g as AssetUploadOptions, C as CreateTaskOptions, h as CreateTaskRequest, i as MediaAsset, j as MediaAssetStatus, k as MediaKind, l as RequestDetails, a as RunResult, R as RunTaskOptions, n as Task, o as TaskCost, p as TaskError, q as TaskEvent, r as TaskEventType, s as TaskListParams, t as TaskPage, u as TaskProgress, v as TaskReceipt, c as TaskResult, w as TaskStatus, x as TaskTiming, y as TaskUsage, z as TaskWebhookConfig, B as TerminalTaskStatus, V as VerifyWebhookOptions, W as WaitTaskOptions, D as WatchTaskOptions } from './types-CvKdgo7V.js';
-export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, r as CursorPage, F as FetchLike, v as JsonObject, w as JsonPrimitive, J as JsonValue, M as MediaGeometryField, g as MediaGeometryProjection, x as ModelCapabilitySummary, y as ModelDateVersion, z as ModelEndpointSummary, A as ModelModality, B as ModelResourceList, D as ModelResourceOption, t as ModelSchema, q as ModelSearchParams, h as NexraBillingCurrency, d as NexraCatalogRevision, u as NexraClientOptions, c as NexraDisplayQuoteBatch, E as NexraDisplayQuoteBatchEntry, j as NexraModelOperation, e as NexraModelSpec, f as NexraModelSpecFilter, a as NexraQuote, k as NexraSalePrice, N as NexraSalePriceList, l as NexraSettlement, s as TaskModel, T as TaskModelSummary, U as UnifiedMediaGeometry } from './media-geometry-Ckr1-Mh3.js';
+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 { 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';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byte_fluffy/nexra-sdk",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.21",
   "type": "module",
   "types": "./dist/index.d.ts",
   "sideEffects": false,
@@ -32,6 +32,10 @@
     "./types": {
       "types": "./dist/types.d.ts",
       "import": "./dist/types.js"
+    },
+    "./media": {
+      "types": "./dist/media.d.ts",
+      "import": "./dist/media.js"
     }
   },
   "publishConfig": {