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

package/README.md

@@ -9,18 +9,14 @@ npm install @byte_fluffy/nexra-sdk@next
 ```
 
 ```ts
-import { createNexra, getModelSpec, projectMediaGeometry } from "@byte_fluffy/nexra-sdk";
+import { createNexra, getModelSpec, type NexraImageGenerateInput } from "@byte_fluffy/nexra-sdk";
 
 const nexra = createNexra({ apiKey: process.env.NEXRA_API_KEY });
 const spec = getModelSpec("openai/gpt-image-2");
-const geometry = projectMediaGeometry(spec!.operations[0]!.inputSchema);
-// geometry.resolution.options → ["1K","2K","4K"]; geometry.ratio.options → ["1:1", ...]
-
-const input = {
-  model: spec!.id,
-  prompt: "A paper boat on a blue table",
-  resolution: "1K",
-  ratio: "1:1",
+const input: NexraImageGenerateInput = {
+  content: [{ type: "text", text: "A paper boat on a blue table", role: "prompt" }],
+  resolution: "1k",
+  aspect_ratio: "1:1",
   quality: "medium",
 };
 const quote = await nexra.catalog.quote({
@@ -28,10 +24,15 @@ const quote = await nexra.catalog.quote({
   operation: "image.generate",
   input,
 });
-const result = await nexra.run(spec!.id, { input, quoteToken: quote.quoteToken });
+const result = await nexra.run(spec!.id, input, { quoteToken: quote.quoteToken });
 ```
 
-Apps should send the unified geometry (`resolution` + `ratio` + `quality`). Quote and `run`/`create` map those fields onto the model's native catalog parameters (GPT Image `size: 1024x1024`, Seedream `size: 2K`, Grok `resolution: 1k` + `aspect_ratio`, …). `encodeMediaGeometry` / `decodeMediaGeometry` expose the same mapping without making a request. Native `size` already in the body is left unchanged.
+Media apps send the versioned Nexra category contract: ordered `content` parts plus
+the common parameters for `image.generate`, `video.generate`, `audio.generate` or
+`image.upscale`. The server resolves the selected model component and explicitly
+adapts that input to the channel Provider. The SDK does not expose or emulate
+Provider-native endpoints. Protocol constants, schemas and types are also
+available from `@byte_fluffy/nexra-sdk/media`.
 
 The default API base URL is `https://api.nexra-ai.com/v1`. When overriding
 `baseUrl`, include the `/v1` API prefix.

package/dist/assets-dUJMQNJD.d.ts

@@ -0,0 +1,61 @@
+import { J as JsonObject } from './json-Drjj1OKl.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;
+}
+
+export { type AssetReference as A, MEDIA_KINDS as M, type AssetImportRequest as a, type AssetInput as b, type AssetUploadOptions as c, type MediaAsset as d, type MediaAssetStatus as e, type MediaKind as f, type AssetCertificationRequest as g, type AssetCertification as h, type AssetCertificationWaitOptions as i };

package/dist/catalog.d.ts

@@ -1,5 +1,6 @@
-import { H as HttpTransport, N as NexraSalePriceList, C as CreateNexraQuoteRequest, a as NexraQuote, b as CreateNexraDisplayQuoteBatchRequest, c as NexraDisplayQuoteBatch, d as NexraCatalogRevision, e as NexraModelSpec, f as NexraModelSpecFilter } from './media-geometry-Ckr1-Mh3.js';
-export { M as MediaGeometryField, g as MediaGeometryProjection, h as NexraBillingCurrency, i as NexraModelEndpointSpec, j as NexraModelOperation, k as NexraSalePrice, 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 { H as HttpTransport, N as NexraSalePriceList, C as CreateNexraQuoteRequest, a as NexraQuote, b as CreateNexraDisplayQuoteBatchRequest, c as NexraDisplayQuoteBatch, d as NexraCatalogRevision, e as NexraModelSpec, f as NexraModelSpecFilter } from './media-geometry-Bo6ukeIQ.js';
+export { M as MediaGeometryField, g as MediaGeometryProjection, h as NexraBillingCurrency, i as NexraModelEndpointSpec, j as NexraModelOperation, k as NexraSalePrice, l as NexraSettlement, U as UnifiedMediaGeometry, m as applyMediaGeometry, n as decodeMediaGeometry, o as encodeMediaGeometry, p as projectMediaGeometry } from './media-geometry-Bo6ukeIQ.js';
+import './json-Drjj1OKl.js';
 
 declare class CatalogClient {
     private readonly transport;

package/dist/catalog.js

@@ -6,7 +6,8 @@ import {
   getModelSpec,
   listModelSpecs,
   projectMediaGeometry
-} from "./chunk-2DKVYO26.js";
+} from "./chunk-7V2P2UQD.js";
+import "./chunk-TA3YGQQY.js";
 export {
   CatalogClient,
   applyMediaGeometry,