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

package/README.md

@@ -9,14 +9,18 @@ npm install @byte_fluffy/nexra-sdk@next
 ```
 
 ```ts
-import { createNexra, getModelSpec, type NexraImageGenerateInput } from "@byte_fluffy/nexra-sdk";
+import { createNexra, getModelSpec, projectMediaGeometry } from "@byte_fluffy/nexra-sdk";
 
 const nexra = createNexra({ apiKey: process.env.NEXRA_API_KEY });
 const spec = getModelSpec("openai/gpt-image-2");
-const input: NexraImageGenerateInput = {
-  content: [{ type: "text", text: "A paper boat on a blue table", role: "prompt" }],
-  resolution: "1k",
-  aspect_ratio: "1:1",
+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",
   quality: "medium",
 };
 const quote = await nexra.catalog.quote({
@@ -24,15 +28,10 @@ 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 });
 ```
 
-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`.
+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.
 
 The default API base URL is `https://api.nexra-ai.com/v1`. When overriding
 `baseUrl`, include the `/v1` API prefix.

package/dist/catalog.d.ts

@@ -1,6 +1,5 @@
-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';
+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';
 
 declare class CatalogClient {
     private readonly transport;

package/dist/catalog.js

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