@byte_fluffy/nexra-sdk 0.1.0-alpha.35 → 0.1.0-alpha.37

package/README.md

@@ -37,6 +37,41 @@ 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.
 
+## Banana 2.1
+
+Use `google/gemini-nano-banana-2.1` for Banana 2.1. The model supports
+`1K` (default), `2K`, and `4K`, fifteen aspect ratios, and up to fourteen
+source/reference images. It does not support `512`, `count`, or `seed`.
+
+```ts
+const modelId = "google/gemini-nano-banana-2.1";
+const input: NexraImageGenerateInput = {
+  content: [{ type: "text", text: "A paper boat on a blue table", role: "prompt" }],
+  resolution: "2K",
+  aspect_ratio: "16:9",
+};
+const quote = await nexra.catalog.quote({ modelId, operation: "image.generate", input });
+const result = await nexra.run(modelId, input, { quoteToken: quote.quoteToken });
+```
+
+The server also exposes the Google Native `generateContent` endpoint at
+`/v1/projects/{project}/locations/global/publishers/google/models/gemini-nano-banana-2.1:generateContent`.
+Use the Native `contents` and `generationConfig` payload for direct HTTP calls;
+SDK media calls use the Nexra contract shown above.
+
+## DeepSeek model identity correction
+
+`0.1.0-alpha.36` replaces `ctyun/deepseek-v4-1-flash` with
+`deepseek/deepseek-v4-1-flash`. Update model IDs in SDK calls, direct HTTP
+requests, persisted selections and catalog caches. Upgrading the SDK does not
+rewrite a hardcoded model ID. The previous public ID and `deepseek-v4.1-flash`
+alias are retired; neither resolves in the new catalog.
+
+The server rollout must apply migration `0056_deepseek_model_identity` before
+syncing the new model definition. The model UUID, channel-specific upstream IDs,
+routes, prices and original request history remain attached to the same model.
+The API paths and native payload shapes remain unchanged.
+
 ## Error contract migration
 
 `0.1.0-alpha.30` introduces the flat public error response and matching SDK

package/dist/catalog.js

@@ -9,8 +9,8 @@ import {
   listModelSpecs,
   projectMediaGeometry,
   resolveNexraLanguageReasoning
-} from "./chunk-HVCSMBOG.js";
-import "./chunk-R4BEO26Q.js";
+} from "./chunk-ENL3IGRX.js";
+import "./chunk-AAGTZN2G.js";
 export {
   CatalogClient,
   applyMediaGeometry,

package/dist/{chunk-R4BEO26Q.js → chunk-AAGTZN2G.js}

@@ -694,6 +694,31 @@ function isTerminalTaskStatus(status) {
   return status === "succeeded" || status === "failed" || status === "cancelled";
 }
 
+// ../contracts/src/usage-query-reference.ts
+var USAGE_QUERY_LIST_FILTERS = [
+  "userIds",
+  "apiKeyIds",
+  "providerIds",
+  "channelIds",
+  "modelIds",
+  "operations",
+  "requestStatuses",
+  "usageSources",
+  "normalizationStatuses",
+  "ratingStatuses"
+];
+var USAGE_QUERY_PARAMETERS = [
+  "start",
+  "end",
+  "timeZoneOffsetMinutes",
+  "groupBy",
+  "limit",
+  "cursor",
+  ...USAGE_QUERY_LIST_FILTERS,
+  "upstreamModelId",
+  "breakdown"
+];
+
 // ../contracts/src/admin-errors.ts
 var CALL_ERROR_STATUSES = ["failed", "rejected", "delivery_failed"];
 var CALL_ANOMALY_STATUSES = [...CALL_ERROR_STATUSES, "cancelled"];