@byte_fluffy/nexra-sdk 0.1.0-alpha.2 → 0.1.0-alpha.20

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,55 @@ 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`.
+
+The static catalog includes the 13 verified Agnes and CTYun image/video model
+contracts. A catalog entry describes parameters; it does not grant access to a
+private model or publish a sale price. Check the selected environment's model
+listing and current prices before submitting a task.
+
+GPT-6 Sol and GPT-6 Luna are included in the language model catalog. Sale prices
+are not bundled into the SDK; use the current prices published by the selected
+Nexra environment:
+
+```ts
+const { prices } = await nexra.catalog.listPrices();
+const gpt6Prices = prices.filter(({ modelId }) =>
+  modelId === "openai/gpt-6-sol" || modelId === "openai/gpt-6-luna"
+);
+```
+
+## 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  Image model specs
+      language.generated.json  Text/language model specs
+      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 model spec
+
+1. Add its ID to `SDK_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,15 @@
-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';
+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;
+    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 { CatalogClient, CreateNexraDisplayQuoteBatchRequest, CreateNexraQuoteRequest, NexraCatalogRevision, NexraDisplayQuoteBatch, NexraModelSpec, NexraModelSpecFilter, NexraQuote, NexraSalePriceList, getModelSpec, listModelSpecs };

package/dist/catalog.js

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