@byte_fluffy/nexra-sdk 0.1.0-alpha.4 → 0.1.0-alpha.5

package/README.md

@@ -9,14 +9,18 @@ npm install @byte_fluffy/nexra-sdk@next
 ```
 
 ```ts
-import { createNexra, getModelSpec } 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("gpt-image-2");
+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",
-  size: "1024x1024",
+  resolution: "1K",
+  ratio: "1:1",
   quality: "medium",
 };
 const quote = await nexra.catalog.quote({
@@ -27,6 +31,8 @@ const quote = await nexra.catalog.quote({
 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.
+
 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 +1 @@
-export { d as CatalogClient, h as CreateNexraQuoteRequest, u as NexraBillingCurrency, v as NexraModelOperation, w as NexraModelSpec, x as NexraModelSpecFilter, y as NexraQuote, z as NexraSalePrice, N as NexraSettlement, R as getModelSpec, V as listModelSpecs } from './index-mytCeh5t.js';
+export { d as CatalogClient, h as CreateNexraQuoteRequest, j as MediaGeometryField, k as MediaGeometryProjection, w as NexraBillingCurrency, x as NexraModelOperation, y as NexraModelSpec, z as NexraModelSpecFilter, A as NexraQuote, D as NexraSalePrice, N as NexraSettlement, U as UnifiedMediaGeometry, S as applyMediaGeometry, W as decodeMediaGeometry, X as encodeMediaGeometry, Z as getModelSpec, $ as listModelSpecs, a0 as projectMediaGeometry } from './index-FyUOK0F-.js';

package/dist/catalog.js

@@ -1,10 +1,18 @@
 import {
   CatalogClient,
+  applyMediaGeometry,
+  decodeMediaGeometry,
+  encodeMediaGeometry,
   getModelSpec,
-  listModelSpecs
-} from "./chunk-AV3GN4TV.js";
+  listModelSpecs,
+  projectMediaGeometry
+} from "./chunk-2C2ZZKUC.js";
 export {
   CatalogClient,
+  applyMediaGeometry,
+  decodeMediaGeometry,
+  encodeMediaGeometry,
   getModelSpec,
-  listModelSpecs
+  listModelSpecs,
+  projectMediaGeometry
 };