@byte_fluffy/nexra-sdk 0.1.0-alpha.16 → 0.1.0-alpha.18

package/dist/catalog.js

@@ -6,7 +6,7 @@ import {
   getModelSpec,
   listModelSpecs,
   projectMediaGeometry
-} from "./chunk-5FVL2U56.js";
+} from "./chunk-VFIIDWIH.js";
 export {
   CatalogClient,
   applyMediaGeometry,

package/dist/{chunk-5FVL2U56.js → chunk-VFIIDWIH.js}

@@ -3779,8 +3779,10 @@ var image_generated_default = [
                   default: false,
                   "x-ui": {
                     order: 4,
-                    control: "switch"
-                  }
+                    control: "switch",
+                    hidden: true
+                  },
+                  const: false
                 },
                 seed: {
                   type: "integer",
@@ -4259,8 +4261,10 @@ var image_generated_default = [
                   default: false,
                   "x-ui": {
                     order: 4,
-                    control: "switch"
-                  }
+                    control: "switch",
+                    hidden: true
+                  },
+                  const: false
                 },
                 seed: {
                   type: "integer",
@@ -4846,8 +4850,10 @@ var image_generated_default = [
               title: "\u6C34\u5370",
               description: "\u662F\u5426\u6DFB\u52A0\u6C34\u5370\u3002",
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             }
           },
           required: [
@@ -5085,8 +5091,10 @@ var image_generated_default = [
               title: "\u6C34\u5370",
               description: "\u662F\u5426\u6DFB\u52A0\u6C34\u5370\u3002",
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             },
             layer_decomposition: {
               type: "boolean",
@@ -21669,9 +21677,11 @@ var video_generated_default = [
               description: "Whether to add an AI Generated watermark to the output.",
               "x-ui": {
                 order: 10,
-                control: "switch"
+                control: "switch",
+                hidden: true
               },
-              default: false
+              default: false,
+              const: false
             },
             seed: {
               type: "integer",
@@ -22153,6 +22163,11 @@ var video_generated_default = [
             {
               metric: "output_video_seconds",
               requirement: "required"
+            },
+            {
+              metric: "input_video_seconds",
+              requirement: "conditional",
+              whenFeature: "task_input_video_v1"
             }
           ]
         }
@@ -22759,8 +22774,10 @@ var video_generated_default = [
               title: "\u89C6\u9891\u6C34\u5370",
               default: false,
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             },
             return_last_frame: {
               type: "boolean",
@@ -23492,8 +23509,10 @@ var video_generated_default = [
               title: "\u89C6\u9891\u6C34\u5370",
               default: false,
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             },
             return_last_frame: {
               type: "boolean",
@@ -24225,8 +24244,10 @@ var video_generated_default = [
               title: "\u89C6\u9891\u6C34\u5370",
               default: false,
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             },
             return_last_frame: {
               type: "boolean",
@@ -25213,8 +25234,10 @@ var video_generated_default = [
               title: "\u89C6\u9891\u6C34\u5370",
               default: false,
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             },
             return_last_frame: {
               type: "boolean",
@@ -26159,8 +26182,10 @@ var video_generated_default = [
               title: "\u89C6\u9891\u6C34\u5370",
               default: false,
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             },
             return_last_frame: {
               type: "boolean",
@@ -26920,8 +26945,10 @@ var video_generated_default = [
               title: "\u89C6\u9891\u6C34\u5370",
               default: false,
               "x-ui": {
-                order: 5
-              }
+                order: 5,
+                hidden: true
+              },
+              const: false
             },
             return_last_frame: {
               type: "boolean",
@@ -27678,8 +27705,10 @@ var video_generated_default = [
               title: "\u89C6\u9891\u6C34\u5370",
               default: false,
               "x-ui": {
-                order: 7
-              }
+                order: 7,
+                hidden: true
+              },
+              const: false
             },
             return_last_frame: {
               type: "boolean",
@@ -34311,6 +34340,24 @@ function applyMediaGeometry(inputSchema, input) {
   return next;
 }
 
+// src/catalog/watermark.ts
+function isObject2(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isFixedOff(field) {
+  return isObject2(field) && field.type === "boolean" && field.const === false;
+}
+function applyNoWatermark(inputSchema, input) {
+  const properties = isObject2(inputSchema.properties) ? inputSchema.properties : {};
+  if (isFixedOff(properties.watermark)) return { ...input, watermark: false };
+  const parametersSchema = isObject2(properties.parameters) ? properties.parameters : {};
+  const parameterProperties = isObject2(parametersSchema.properties) ? parametersSchema.properties : {};
+  if (isFixedOff(parameterProperties.watermark)) {
+    return { ...input, parameters: { ...isObject2(input.parameters) ? input.parameters : {}, watermark: false } };
+  }
+  return input;
+}
+
 // src/errors.ts
 var NexraApiError = class extends Error {
   status;
@@ -34348,7 +34395,7 @@ var NexraWaitTimeoutError = class extends Error {
 };
 
 // src/generated/version.generated.ts
-var SDK_VERSION = "0.1.0-alpha.16";
+var SDK_VERSION = "0.1.0-alpha.18";
 
 // src/transport.ts
 var DEFAULT_BASE_URL = "https://api.nexra-ai.com/v1";
@@ -34494,7 +34541,7 @@ var CatalogClient = class {
   quote(request, signal) {
     const spec = getModelSpec(request.modelId);
     const schema = spec?.operations.find((operation) => operation.operation === request.operation)?.inputSchema ?? spec?.operations[0]?.inputSchema;
-    const input = schema ? applyMediaGeometry(schema, request.input) : request.input;
+    const input = schema ? applyNoWatermark(schema, applyMediaGeometry(schema, request.input)) : request.input;
     return this.transport.json(
       "/catalog/quotes",
       { method: "POST", ...jsonBody({ ...request, input }), signal },
@@ -34504,7 +34551,7 @@ var CatalogClient = class {
   quoteBatch(request, signal) {
     const spec = getModelSpec(request.modelId);
     const schema = spec?.operations.find((operation) => operation.operation === request.operation)?.inputSchema ?? spec?.operations[0]?.inputSchema;
-    const entries = schema ? request.entries.map((entry) => ({ ...entry, input: applyMediaGeometry(schema, entry.input) })) : request.entries;
+    const entries = schema ? request.entries.map((entry) => ({ ...entry, input: applyNoWatermark(schema, applyMediaGeometry(schema, entry.input)) })) : request.entries;
     return this.transport.json(
       "/catalog/quotes/batch",
       { method: "POST", ...jsonBody({ ...request, entries }), signal },
@@ -34550,6 +34597,7 @@ export {
   encodeMediaGeometry,
   decodeMediaGeometry,
   applyMediaGeometry,
+  applyNoWatermark,
   CatalogClient,
   getModelSpec,
   listModelSpecs

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AssetsClient, T as TasksClient, R as RunTaskOptions, a as RunResult, b as ApiErrorPayload, c as TaskResult } from './types-5jsH7tBX.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-5jsH7tBX.js';
+import { A as AssetsClient, T as TasksClient, R as RunTaskOptions, a as RunResult, b as ApiErrorPayload, c as TaskResult } from './types-Dwy7j1S1.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-Dwy7j1S1.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';
 import { CatalogClient } from './catalog.js';

package/dist/index.js

@@ -7,6 +7,7 @@ import {
   NexraWaitTimeoutError,
   TASK_STATUSES,
   applyMediaGeometry,
+  applyNoWatermark,
   decodeMediaGeometry,
   encodeMediaGeometry,
   getModelSpec,
@@ -16,7 +17,7 @@ import {
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-5FVL2U56.js";
+} from "./chunk-VFIIDWIH.js";
 import {
   ceilDecimal,
   multiplyDecimal
@@ -280,7 +281,7 @@ var TasksClient = class {
   assets;
   async create(model, options) {
     const schema = getModelSpec(model)?.operations[0]?.inputSchema;
-    const mapped = schema && options.input && typeof options.input === "object" && !Array.isArray(options.input) ? applyMediaGeometry(schema, options.input) : options.input;
+    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,
@@ -350,7 +351,9 @@ var TasksClient = class {
         const event = JSON.parse(serverEvent.data);
         yield event;
         if (event.status && isTerminalTaskStatus(event.status)) {
-          reachedTerminalState = true;
+          const task = event.payload?.task;
+          const deliveryPreparing = task && typeof task === "object" && !Array.isArray(task) && task.deliveryStatus === "preparing";
+          if (!deliveryPreparing) reachedTerminalState = true;
         }
       }
       if (reachedTerminalState) return;

package/dist/{types-5jsH7tBX.d.ts → types-Dwy7j1S1.d.ts}

@@ -100,10 +100,18 @@ interface TaskTiming {
     submittedAt: string;
     providerSubmittedAt?: string;
     providerCompletedAt?: string;
+    /** First public terminal response; background media may still be preparing. */
+    firstResponseAt?: string;
+    /** Background media ready response; absent while preparing or after persistence failure. */
+    secondResponseAt?: string;
     storedAt?: string;
+    persistPolicy?: "terminal" | "background";
+    deliveryStatus?: "preparing" | "ready" | "failed";
     preparationMs: number | null;
     generationMs: number | null;
     storageMs: number | null;
+    /** Background persistence elapsed time from first response to durable asset readiness. */
+    persistMs?: number | null;
     totalMs: number | null;
     startSource: "client" | "server";
     /** Server clock reading taken when this snapshot was built; lets clients anchor live timers to server time. */
@@ -122,8 +130,16 @@ interface Task<TOutput = JsonValue> {
     /** Model request parameters; native-managed tasks retain the upstream field structure. */
     input?: JsonObject;
     status: TaskStatus;
-    /** Regional media availability; execution/billing remain terminal while replicas prepare. */
-    deliveryStatus?: "preparing" | "ready";
+    /** Persistence policy frozen when the Task is created. Background is limited to video Tasks. */
+    persistPolicy?: "terminal" | "background";
+    /**
+     * Regional media availability. "preparing" means the task result is delivered
+     * with provider media URLs while Nexra persists them to its own object storage
+     * in the background; "ready" means persisted URLs; "failed" means background
+     * persistence exhausted its retries and the provider URLs have expired.
+     * Execution/billing remain terminal regardless of this value.
+     */
+    deliveryStatus?: "preparing" | "ready" | "failed";
     progress?: TaskProgress;
     /** Native-managed tasks preserve the final response shape and media URLs; catalog models may normalize model identifiers. */
     output?: TOutput;
@@ -135,7 +151,13 @@ interface Task<TOutput = JsonValue> {
     billingStatus?: "pending" | "succeeded" | "failed" | "refunded" | "unavailable";
     /** Final customer sale settlement. Provider procurement cost is never exposed here. */
     settlement?: NexraSettlement;
-    /** Caller-supplied business data, returned unchanged; never sent to the provider. */
+    /**
+     * Caller-supplied business data, returned unchanged; never sent to the provider.
+     * The platform extracts the reserved string keys `callerUrl` (caller origin,
+     * https URL) and `endUserId` (opaque end-user identifier) into dedicated
+     * attribution columns for support diagnostics; their values are not validated
+     * beyond format checks and remain unchanged inside `metadata`.
+     */
     metadata?: JsonObject;
     timing?: TaskTiming;
     /** Server-side Task record creation time (ISO 8601 UTC). */
@@ -144,7 +166,12 @@ interface Task<TOutput = JsonValue> {
     updatedAt: string;
     /** First worker execution start; absent while queued or cancelled before execution. */
     startedAt?: string;
-    /** Terminal succeeded/failed/cancelled time; success follows required asset storage. */
+    /**
+     * Terminal succeeded/failed/cancelled time. Synchronously persisted tasks
+     * (default) reach succeeded only after required asset storage; background-
+     * persisted tasks are declared succeeded at result delivery while storage
+     * continues, signalled by `deliveryStatus` and the task timing second response.
+     */
     completedAt?: string;
     /** @deprecated Reserved; no Task expiry policy is currently enforced. Not a media URL expiry. */
     expiresAt?: string;
@@ -152,7 +179,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" | "deliveryStatus" | "settlement">>;
+type TaskResult<TOutput = JsonValue> = Pick<Task<TOutput>, "id" | "model" | "status"> & Partial<Pick<Task<TOutput>, "requestId" | "output" | "assets" | "error" | "persistPolicy" | "deliveryStatus" | "settlement">>;
 /** Platform request details, used by both managed Tasks and native proxy requests. */
 interface RequestDetails {
     id: string;
@@ -167,6 +194,8 @@ interface RequestDetails {
     status: string;
     /** Linked Task lifecycle when this request accepted a Task; HTTP `status` stays accepted. */
     taskStatus?: string | null;
+    persistPolicy?: "terminal" | "background";
+    deliveryStatus?: Task["deliveryStatus"];
     httpStatus: number | null;
     errorCode: string | null;
     /** HTTP duration, never substituted with asynchronous task duration. */
@@ -176,6 +205,12 @@ interface RequestDetails {
     billingStatus?: Task["billingStatus"];
     settlement?: NexraSettlement;
     metadata?: JsonObject;
+    /** Caller-asserted origin extracted from metadata.callerUrl; diagnostics display only. */
+    callerUrl?: string | null;
+    /** Caller-asserted end-user identifier extracted from metadata.endUserId; diagnostics display only. */
+    endUserId?: string | null;
+    /** Name of the API key that authenticated this request; diagnostics display only. */
+    apiKeyName?: string | null;
     /** Latest known execution update; omitted when not observed. */
     updatedAt?: string;
     runId?: string;

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-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-5jsH7tBX.js';
+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-Dwy7j1S1.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';

package/package.json

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