@byte_fluffy/nexra-sdk 0.1.0-alpha.3 → 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,9 +31,39 @@ 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.
 
 Static catalog APIs are also available from `@byte_fluffy/nexra-sdk/catalog`.
 Exact non-negative decimal helpers are available from
 `@byte_fluffy/nexra-sdk/decimal`.
+
+## Directory layout
+
+```
+src/
+  index.ts                  Public entry; re-exports the catalog, client, etc.
+  catalog/
+    index.ts                CatalogClient, getModelSpec, listModelSpecs
+    generated/              Generated artifacts (committed; required to publish)
+      image.generated.json  One file per model kind (image, video, audio, ...)
+      index.ts              Imports every kind JSON and exports the merged array
+  generated/
+    version.generated.ts    SDK_VERSION used by the transport
+  ...                       client, tasks, assets, input, sse, webhooks, errors, ...
+scripts/
+  generate-public-catalog.ts  Projects models from @nexra/models and writes
+                              src/catalog/generated/*
+```
+
+### Adding a new public model
+
+1. Add its ID to `PUBLIC_MODEL_IDS` in `scripts/generate-public-catalog.ts`.
+2. Run `bun run generate` (from `packages/sdk`).
+3. The script groups projected models by `model.kind`, writes one
+   `src/catalog/generated/<kind>.generated.json` per kind (new kinds appear
+   automatically), regenerates the merging `index.ts`, and bumps
+   `src/generated/version.generated.ts`. No hand-written code changes.
+

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 './catalog-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-IMJZBLDE.js";
+  listModelSpecs,
+  projectMediaGeometry
+} from "./chunk-2C2ZZKUC.js";
 export {
   CatalogClient,
+  applyMediaGeometry,
+  decodeMediaGeometry,
+  encodeMediaGeometry,
   getModelSpec,
-  listModelSpecs
+  listModelSpecs,
+  projectMediaGeometry
 };