@byte_fluffy/nexra-sdk 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/{index-FyUOK0F-.d.ts → index-CAi88bUo.d.ts}

@@ -121,6 +121,10 @@ interface ModelCapabilitySummary {
     /** User-facing input patterns such as text-to-video or image-to-image. */
     inputModes: string[];
     features: string[];
+    /** Maximum combined input and output context supported by the model. */
+    contextWindowTokens?: number;
+    /** Maximum generated output tokens supported by the model. */
+    maxOutputTokens?: number;
 }
 interface ModelDateVersion {
     id: string;
@@ -228,6 +232,15 @@ interface NexraModelOperation {
     outputSchema: JsonObject;
     metering: MeteringContract;
 }
+/** Public native wire endpoint metadata. Provider routing and credentials stay private. */
+interface NexraModelEndpointSpec {
+    endpointKey: string;
+    operation: string;
+    protocol: string;
+    method: string;
+    path: string;
+    capabilities: readonly string[];
+}
 interface NexraModelSpec {
     id: string;
     contractVersion: number;
@@ -240,6 +253,7 @@ interface NexraModelSpec {
     aliases: readonly string[];
     capabilities: ModelCapabilitySummary;
     operations: readonly NexraModelOperation[];
+    endpoints: readonly NexraModelEndpointSpec[];
 }
 interface NexraModelSpecFilter {
     kind?: ModelModality;
@@ -253,11 +267,23 @@ interface NexraSalePrice {
     effectiveFrom: string;
     rule: PriceRule;
 }
+interface NexraSalePriceList {
+    currency: NexraBillingCurrency;
+    prices: readonly NexraSalePrice[];
+}
 interface CreateNexraQuoteRequest {
     modelId: string;
     operation: string;
     input: JsonObject;
 }
+interface CreateNexraDisplayQuoteBatchRequest {
+    modelId: string;
+    operation: string;
+    entries: readonly Readonly<{
+        key: string;
+        input: JsonObject;
+    }>[];
+}
 interface NexraQuote {
     quoteToken: string;
     modelId: string;
@@ -269,6 +295,32 @@ interface NexraQuote {
     accuracy: "exact" | "estimated";
     expiresAt: string;
 }
+type NexraDisplayQuoteBatchEntry = Readonly<{
+    key: string;
+    amount: string;
+    maximumAmount: string;
+    accuracy: "exact" | "estimated";
+}> | Readonly<{
+    key: string;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+interface NexraDisplayQuoteBatch {
+    modelId: string;
+    contractVersion: number;
+    priceRevision: string;
+    pricingPolicyRevision: string;
+    quoteContextRevision: string;
+    currency: NexraBillingCurrency;
+    entries: readonly NexraDisplayQuoteBatchEntry[];
+    expiresAt: string;
+}
+interface NexraCatalogRevision {
+    revision: string;
+    changedAt: string;
+}
 interface NexraSettlement {
     amount: string;
     currency: NexraBillingCurrency;
@@ -336,9 +388,12 @@ declare function applyMediaGeometry(inputSchema: JsonObject, input: JsonObject):
 declare class CatalogClient {
     private readonly transport;
     constructor(transport: HttpTransport);
+    listPrices(signal?: AbortSignal): Promise<NexraSalePriceList>;
     quote(request: CreateNexraQuoteRequest, signal?: AbortSignal): Promise<NexraQuote>;
+    quoteBatch(request: CreateNexraDisplayQuoteBatchRequest, signal?: AbortSignal): Promise<NexraDisplayQuoteBatch>;
+    revision(signal?: AbortSignal): Promise<NexraCatalogRevision>;
 }
 declare function getModelSpec(modelId: string): NexraModelSpec | undefined;
 declare function listModelSpecs(filter?: NexraModelSpecFilter): readonly NexraModelSpec[];
 
-export { listModelSpecs as $, type NexraQuote as A, type BillingMetric as B, type CursorPage as C, type NexraSalePrice as D, type NormalizedUsageV1 as E, type FetchLike as F, type PriceEvaluationIssue as G, HttpTransport as H, type PriceEvaluationLine as I, type JsonObject as J, type PriceRule as K, type UsageComponentEvidence as L, type ModelSchema as M, type NexraSettlement as N, type UsageEvidenceAssessment as O, type PriceEvaluation as P, type UsageEvidenceStatus as Q, allocateDiscountedPriceLines as R, applyMediaGeometry as S, type TaskModelSummary as T, type UnifiedMediaGeometry as U, assessUsageEvidence as V, decodeMediaGeometry as W, encodeMediaGeometry as X, evaluatePriceRule as Y, getModelSpec as Z, jsonBody as _, type JsonValue as a, projectMediaGeometry as a0, queryString as a1, sleep as a2, validateMeteringContract as a3, validateNormalizedUsage as a4, validatePriceRule as a5, type ModelSearchParams as b, type TaskModel as c, CatalogClient as d, type NexraClientOptions as e, BILLING_EXPORT_DIMENSIONS as f, BILLING_METRICS as g, type CreateNexraQuoteRequest as h, type JsonPrimitive as i, type MediaGeometryField as j, type MediaGeometryProjection as k, type MeteredPriceRate as l, type MeteredPriceRuleV1 as m, type MeteredUsageComponent as n, type MeteringContract as o, type MeteringKind as p, type ModelCapabilitySummary as q, type ModelDateVersion as r, type ModelEndpointSummary as s, type ModelModality as t, type ModelResourceList as u, type ModelResourceOption as v, type NexraBillingCurrency as w, type NexraModelOperation as x, type NexraModelSpec as y, type NexraModelSpecFilter as z };
+export { assessUsageEvidence as $, type NexraDisplayQuoteBatchEntry as A, type BillingMetric as B, type CursorPage as C, type NexraModelEndpointSpec as D, type NexraModelOperation as E, type FetchLike as F, type NexraModelSpec as G, HttpTransport as H, type NexraModelSpecFilter as I, type JsonObject as J, type NexraQuote as K, type NexraSalePrice as L, type ModelSchema as M, type NexraSettlement as N, type NexraSalePriceList as O, type NormalizedUsageV1 as P, type PriceEvaluation as Q, type PriceEvaluationIssue as R, type PriceEvaluationLine as S, type TaskModelSummary as T, type PriceRule as U, type UnifiedMediaGeometry as V, type UsageComponentEvidence as W, type UsageEvidenceAssessment as X, type UsageEvidenceStatus as Y, allocateDiscountedPriceLines as Z, applyMediaGeometry as _, type JsonValue as a, decodeMediaGeometry as a0, encodeMediaGeometry as a1, evaluatePriceRule as a2, getModelSpec as a3, jsonBody as a4, listModelSpecs as a5, projectMediaGeometry as a6, queryString as a7, sleep as a8, validateMeteringContract as a9, validateNormalizedUsage as aa, validatePriceRule as ab, type ModelSearchParams as b, type TaskModel as c, CatalogClient as d, type NexraClientOptions as e, BILLING_EXPORT_DIMENSIONS as f, BILLING_METRICS as g, type CreateNexraDisplayQuoteBatchRequest as h, type CreateNexraQuoteRequest as i, type JsonPrimitive as j, type MediaGeometryField as k, type MediaGeometryProjection as l, type MeteredPriceRate as m, type MeteredPriceRuleV1 as n, type MeteredUsageComponent as o, type MeteringContract as p, type MeteringKind as q, type ModelCapabilitySummary as r, type ModelDateVersion as s, type ModelEndpointSummary as t, type ModelModality as u, type ModelResourceList as v, type ModelResourceOption as w, type NexraBillingCurrency as x, type NexraCatalogRevision as y, type NexraDisplayQuoteBatch as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { J as JsonObject, B as BillingMetric, a as JsonValue, N as NexraSettlement, C as CursorPage, M as ModelSchema, T as TaskModelSummary, H as HttpTransport, b as ModelSearchParams, c as TaskModel, d as CatalogClient, e as NexraClientOptions } from './index-FyUOK0F-.js';
-export { f as BILLING_EXPORT_DIMENSIONS, g as BILLING_METRICS, h as CreateNexraQuoteRequest, F as FetchLike, i as JsonPrimitive, j as MediaGeometryField, k as MediaGeometryProjection, l as MeteredPriceRate, m as MeteredPriceRuleV1, n as MeteredUsageComponent, o as MeteringContract, p as MeteringKind, q as ModelCapabilitySummary, r as ModelDateVersion, s as ModelEndpointSummary, t as ModelModality, u as ModelResourceList, v as ModelResourceOption, w as NexraBillingCurrency, x as NexraModelOperation, y as NexraModelSpec, z as NexraModelSpecFilter, A as NexraQuote, D as NexraSalePrice, E as NormalizedUsageV1, P as PriceEvaluation, G as PriceEvaluationIssue, I as PriceEvaluationLine, K as PriceRule, U as UnifiedMediaGeometry, L as UsageComponentEvidence, O as UsageEvidenceAssessment, Q as UsageEvidenceStatus, R as allocateDiscountedPriceLines, S as applyMediaGeometry, V as assessUsageEvidence, W as decodeMediaGeometry, X as encodeMediaGeometry, Y as evaluatePriceRule, Z as getModelSpec, _ as jsonBody, $ as listModelSpecs, a0 as projectMediaGeometry, a1 as queryString, a2 as sleep, a3 as validateMeteringContract, a4 as validateNormalizedUsage, a5 as validatePriceRule } from './index-FyUOK0F-.js';
+import { J as JsonObject, B as BillingMetric, a as JsonValue, N as NexraSettlement, C as CursorPage, M as ModelSchema, T as TaskModelSummary, H as HttpTransport, b as ModelSearchParams, c as TaskModel, d as CatalogClient, e as NexraClientOptions } from './index-CAi88bUo.js';
+export { f as BILLING_EXPORT_DIMENSIONS, g as BILLING_METRICS, h as CreateNexraDisplayQuoteBatchRequest, i as CreateNexraQuoteRequest, F as FetchLike, j as JsonPrimitive, k as MediaGeometryField, l as MediaGeometryProjection, m as MeteredPriceRate, n as MeteredPriceRuleV1, o as MeteredUsageComponent, p as MeteringContract, q as MeteringKind, r as ModelCapabilitySummary, s as ModelDateVersion, t as ModelEndpointSummary, u as ModelModality, v as ModelResourceList, w as ModelResourceOption, x as NexraBillingCurrency, y as NexraCatalogRevision, z as NexraDisplayQuoteBatch, A as NexraDisplayQuoteBatchEntry, D as NexraModelEndpointSpec, E as NexraModelOperation, G as NexraModelSpec, I as NexraModelSpecFilter, K as NexraQuote, L as NexraSalePrice, O as NexraSalePriceList, P as NormalizedUsageV1, Q as PriceEvaluation, R as PriceEvaluationIssue, S as PriceEvaluationLine, U as PriceRule, V as UnifiedMediaGeometry, W as UsageComponentEvidence, X as UsageEvidenceAssessment, Y as UsageEvidenceStatus, Z as allocateDiscountedPriceLines, _ as applyMediaGeometry, $ as assessUsageEvidence, a0 as decodeMediaGeometry, a1 as encodeMediaGeometry, a2 as evaluatePriceRule, a3 as getModelSpec, a4 as jsonBody, a5 as listModelSpecs, a6 as projectMediaGeometry, a7 as queryString, a8 as sleep, a9 as validateMeteringContract, aa as validateNormalizedUsage, ab as validatePriceRule } from './index-CAi88bUo.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';
 
 declare const MEDIA_KINDS: readonly ["image", "video", "audio", "document", "archive", "other"];
@@ -590,6 +590,8 @@ interface TaskTiming {
     storageMs: 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. */
+    observedAt?: string;
 }
 /** Repository/console read model. HTTP clients receive TaskReceipt or TaskResult. */
 interface Task<TOutput = JsonValue> {
@@ -996,6 +998,19 @@ declare function adaptSandboxInput(schema: ModelSchema, mode: string, input: Jso
 /** Minimal operation form. Unsupported controls remain explicit provider defaults. */
 declare function sandboxInputSchema(schemas: ModelSchema[], mode: string): ModelSchema;
 
+/** 统一的比例展示顺序契约：`auto` → `1:1` → 常规比例按长边升序成对排列（竖前横后）→ `1:x`/`x:1` 极端长幅收尾。
+ * 所有模型的画面比例选项共用这一顺序，保证规格面板跨模型一致。 */
+type RatioDisplayKey = readonly [number, number, number, number, string];
+declare function ratioDisplayOrderKey(value: string): RatioDisplayKey;
+declare function compareRatioDisplayOrder(a: string, b: string): number;
+declare function sortRatioDisplayOrder(values: readonly string[]): string[];
+/** Reorders ratio/aspect_ratio enums and their optionLabels inside JSON-Schema
+ * properties so every published model presents aspect ratios in one order.
+ * The optionLabels map is normalized to exactly the enum values (stale labels
+ * dropped, missing ones filled with the value itself).
+ * Returns the input reference untouched when nothing needs reordering. */
+declare function orderSchemaRatioProperties(properties: unknown): unknown;
+
 declare class AssetsClient {
     private readonly transport;
     constructor(transport: HttpTransport);
@@ -1093,4 +1108,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 { ADMIN_USER_ACTIVITY_KINDS, ADMIN_USER_ROLES, ADMIN_USER_STATUSES, type AdminOverview, type AdminUserActivityKind, type AdminUserActivityPage, type AdminUserActivityRow, type AdminUserApiKeyUpdate, type AdminUserApiKeyUpdateResult, type AdminUserDetail, type AdminUserDiscountRow, type AdminUserKeyRow, type AdminUserListCursor, type AdminUserListPage, type AdminUserListQuery, type AdminUserPricingAdjustmentRow, type AdminUserRole, type AdminUserStatus, type AdminUserSummaryRow, type AdminUserUpdate, type AdminUserUpdateResult, type AdminUserWalletOpenInput, type AdminUserWalletOpenResult, type AdminUserWalletSummary, type AdminWalletRechargeInput, type AdminWalletRechargeResult, type ApiErrorPayload, type AssetImportRequest, type AssetInput, type AssetReference, type AssetUploadOptions, AssetsClient, type AvailabilityBucket, type AvailabilityObservation, type AvailabilityStats, BILLING_CURRENCY, BillingMetric, CatalogClient, type CreateTaskOptions, type CreateTaskRequest, type CreateTaskRunRequest, CursorPage, HttpTransport, JsonObject, JsonValue, MEDIA_KINDS, MONEY_STRING_PATTERN, type MediaAsset, type MediaAssetStatus, type MediaKind, ModelSchema, ModelSearchParams, ModelsClient, type MoneyString, NexraApiError, NexraClient, NexraClientOptions, NexraSettlement, NexraTaskError, NexraWaitTimeoutError, type ObservationResult, type ProbeRunView, type ProbeTargetConfig, type ProbeTargetView, type RequestDetails, type RunResult, type RunTaskOptions, SANDBOX_OPERATIONS, type SandboxOperation, TASK_STATUSES, TOKEN_METRICS, type Task, type TaskCost, type TaskError, type TaskEvent, type TaskEventType, type TaskListParams, TaskModel, TaskModelSummary, type TaskPage, type TaskProgress, type TaskReceipt, type TaskResult, type TaskRun, type TaskRunListParams, type TaskStatus, type TaskTiming, type TaskUsage, type TaskWebhookConfig, TasksClient, type TerminalTaskStatus, USAGE_AMOUNT_KINDS, USAGE_ANOMALY_CATEGORIES, USAGE_FILTER_KINDS, USAGE_FILTER_SELECTION_LIMIT, USAGE_GROUP_BYS, USAGE_NORMALIZATION_STATUSES, USAGE_RATING_STATUSES, USAGE_SOURCES, type UploadDeliveryRegion, type UsageAmountKind, type UsageAnomaliesPage, type UsageAnomaliesQuery, type UsageAnomalyBreakdownRow, type UsageAnomalyCategory, type UsageAnomalyRow, type UsageAnomalySummaryPage, type UsageAnomalySummaryQuery, type UsageAnomalySummaryRow, type UsageDetailCharge, type UsageDetailRow, type UsageDetailUsage, type UsageDetailsPage, type UsageDetailsQuery, type UsageFilterKind, type UsageFilterOption, type UsageFilterOptionsPage, type UsageFilterOptionsQuery, type UsageFilters, type UsageGroupBy, type UsageNormalizationStatus, type UsageRatingStatus, type UsageSource, type UsageSummaryAmount, type UsageSummaryGroup, type UsageSummaryPage, type UsageSummaryQuery, type UsageSummaryRow, type UsageTimeWindow, type VerifyWebhookOptions, WALLET_MAX_BALANCE_UNITS, type WaitTaskOptions, type WatchTaskOptions, adaptSandboxInput, availabilityBuckets, availabilityStats, classifyObservation, createNexra, defaultProbeInterval, defaultProbeTimeout, encodeAdminUserCursor, encodeUsageFilterCursor, encodeUsageKeysetCursor, encodeUsageSummaryCursor, isMoneyString, isTerminalTaskStatus, modelInputDefaults, modelInputUi, modelUploadRegion, moneyFromUnits, moneyToUnits, multiplyMoney, normalizeModelParameterSchema, orderedSchemaProperties, parseAdminUserCursor, parseUsageFilterCursor, parseUsageKeysetCursor, parseUsageSummaryCursor, probeCostExceeds, rateProbeUsage, sandboxIdentity, sandboxInputSchema, sandboxModelModes, sandboxObject, sandboxOperations, sandboxProperties, sandboxSupports, sandboxVoiceKey, taskReceipt, taskResult, uploadedMediaInput, uploadedMediaUrl, validateAdminUserApiKeyUpdate, validateAdminUserListQuery, validateAdminUserUpdate, validateAdminWalletRechargeInput, validateUsageAnomaliesQuery, validateUsageAnomalySummaryQuery, validateUsageDetailsQuery, validateUsageFilterOptionsQuery, validateUsageFilters, validateUsageSummaryQuery, verifyWebhook };
+export { ADMIN_USER_ACTIVITY_KINDS, ADMIN_USER_ROLES, ADMIN_USER_STATUSES, type AdminOverview, type AdminUserActivityKind, type AdminUserActivityPage, type AdminUserActivityRow, type AdminUserApiKeyUpdate, type AdminUserApiKeyUpdateResult, type AdminUserDetail, type AdminUserDiscountRow, type AdminUserKeyRow, type AdminUserListCursor, type AdminUserListPage, type AdminUserListQuery, type AdminUserPricingAdjustmentRow, type AdminUserRole, type AdminUserStatus, type AdminUserSummaryRow, type AdminUserUpdate, type AdminUserUpdateResult, type AdminUserWalletOpenInput, type AdminUserWalletOpenResult, type AdminUserWalletSummary, type AdminWalletRechargeInput, type AdminWalletRechargeResult, type ApiErrorPayload, type AssetImportRequest, type AssetInput, type AssetReference, type AssetUploadOptions, AssetsClient, type AvailabilityBucket, type AvailabilityObservation, type AvailabilityStats, BILLING_CURRENCY, BillingMetric, CatalogClient, type CreateTaskOptions, type CreateTaskRequest, type CreateTaskRunRequest, CursorPage, HttpTransport, JsonObject, JsonValue, MEDIA_KINDS, MONEY_STRING_PATTERN, type MediaAsset, type MediaAssetStatus, type MediaKind, ModelSchema, ModelSearchParams, ModelsClient, type MoneyString, NexraApiError, NexraClient, NexraClientOptions, NexraSettlement, NexraTaskError, NexraWaitTimeoutError, type ObservationResult, type ProbeRunView, type ProbeTargetConfig, type ProbeTargetView, type RequestDetails, type RunResult, type RunTaskOptions, SANDBOX_OPERATIONS, type SandboxOperation, TASK_STATUSES, TOKEN_METRICS, type Task, type TaskCost, type TaskError, type TaskEvent, type TaskEventType, type TaskListParams, TaskModel, TaskModelSummary, type TaskPage, type TaskProgress, type TaskReceipt, type TaskResult, type TaskRun, type TaskRunListParams, type TaskStatus, type TaskTiming, type TaskUsage, type TaskWebhookConfig, TasksClient, type TerminalTaskStatus, USAGE_AMOUNT_KINDS, USAGE_ANOMALY_CATEGORIES, USAGE_FILTER_KINDS, USAGE_FILTER_SELECTION_LIMIT, USAGE_GROUP_BYS, USAGE_NORMALIZATION_STATUSES, USAGE_RATING_STATUSES, USAGE_SOURCES, type UploadDeliveryRegion, type UsageAmountKind, type UsageAnomaliesPage, type UsageAnomaliesQuery, type UsageAnomalyBreakdownRow, type UsageAnomalyCategory, type UsageAnomalyRow, type UsageAnomalySummaryPage, type UsageAnomalySummaryQuery, type UsageAnomalySummaryRow, type UsageDetailCharge, type UsageDetailRow, type UsageDetailUsage, type UsageDetailsPage, type UsageDetailsQuery, type UsageFilterKind, type UsageFilterOption, type UsageFilterOptionsPage, type UsageFilterOptionsQuery, type UsageFilters, type UsageGroupBy, type UsageNormalizationStatus, type UsageRatingStatus, type UsageSource, type UsageSummaryAmount, type UsageSummaryGroup, type UsageSummaryPage, type UsageSummaryQuery, type UsageSummaryRow, type UsageTimeWindow, type VerifyWebhookOptions, WALLET_MAX_BALANCE_UNITS, type WaitTaskOptions, type WatchTaskOptions, adaptSandboxInput, availabilityBuckets, availabilityStats, classifyObservation, compareRatioDisplayOrder, createNexra, defaultProbeInterval, defaultProbeTimeout, encodeAdminUserCursor, encodeUsageFilterCursor, encodeUsageKeysetCursor, encodeUsageSummaryCursor, isMoneyString, isTerminalTaskStatus, modelInputDefaults, modelInputUi, modelUploadRegion, moneyFromUnits, moneyToUnits, multiplyMoney, normalizeModelParameterSchema, orderSchemaRatioProperties, orderedSchemaProperties, parseAdminUserCursor, parseUsageFilterCursor, parseUsageKeysetCursor, parseUsageSummaryCursor, probeCostExceeds, rateProbeUsage, ratioDisplayOrderKey, sandboxIdentity, sandboxInputSchema, sandboxModelModes, sandboxObject, sandboxOperations, sandboxProperties, sandboxSupports, sandboxVoiceKey, sortRatioDisplayOrder, taskReceipt, taskResult, uploadedMediaInput, uploadedMediaUrl, validateAdminUserApiKeyUpdate, validateAdminUserListQuery, validateAdminUserUpdate, validateAdminWalletRechargeInput, validateUsageAnomaliesQuery, validateUsageAnomalySummaryQuery, validateUsageDetailsQuery, validateUsageFilterOptionsQuery, validateUsageFilters, validateUsageSummaryQuery, verifyWebhook };