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

package/README.md

@@ -33,3 +33,31 @@ The default API base URL is `https://api.nexra-ai.com/v1`. When overriding
 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, 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';

package/dist/catalog.js

@@ -2,7 +2,7 @@ import {
   CatalogClient,
   getModelSpec,
   listModelSpecs
-} from "./chunk-IMJZBLDE.js";
+} from "./chunk-AV3GN4TV.js";
 export {
   CatalogClient,
   getModelSpec,

package/dist/{chunk-IMJZBLDE.js → chunk-AV3GN4TV.js}

@@ -1,5 +1,5 @@
-// src/generated/public-catalog.generated.json
-var public_catalog_generated_default = [
+// src/catalog/generated/image.generated.json
+var image_generated_default = [
   {
     id: "openai/gpt-image-2.5-flare",
     contractVersion: 2,
@@ -6023,6 +6023,11 @@ var public_catalog_generated_default = [
   }
 ];
 
+// src/catalog/generated/index.ts
+var generatedCatalog = Object.freeze([
+  ...image_generated_default
+]);
+
 // src/errors.ts
 var NexraApiError = class extends Error {
   status;
@@ -6060,7 +6065,7 @@ var NexraWaitTimeoutError = class extends Error {
 };
 
 // src/generated/version.generated.ts
-var SDK_VERSION = "0.1.0-alpha.3";
+var SDK_VERSION = "0.1.0-alpha.4";
 
 // src/transport.ts
 var DEFAULT_BASE_URL = "https://api.nexra-ai.com/v1";
@@ -6182,8 +6187,8 @@ async function waitForRetry(response, attempt, signal) {
   await sleep(Number.isFinite(seconds) ? seconds * 1e3 : 200 * 2 ** attempt, signal);
 }
 
-// src/catalog.ts
-var modelSpecs = deepFreeze(structuredClone(public_catalog_generated_default));
+// src/catalog/index.ts
+var modelSpecs = deepFreeze(structuredClone(generatedCatalog));
 var byIdentifier = /* @__PURE__ */ new Map();
 for (const model of modelSpecs) {
   for (const identifier of [model.id, ...model.aliases]) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { J as JsonObject, B as BillingMetric, a as JsonValue, N as NexraSettlement, C as CursorPage, H as HttpTransport, M as ModelSearchParams, T as TaskModelSummary, b as TaskModel, c as ModelSchema, d as CatalogClient, e as NexraClientOptions } from './catalog-mytCeh5t.js';
-export { f as BILLING_EXPORT_DIMENSIONS, g as BILLING_METRICS, h as CreateNexraQuoteRequest, F as FetchLike, i as JsonPrimitive, j as MeteredPriceRate, k as MeteredPriceRuleV1, l as MeteredUsageComponent, m as MeteringContract, n as MeteringKind, o as ModelCapabilitySummary, p as ModelDateVersion, q as ModelEndpointSummary, r as ModelModality, s as ModelResourceList, t as ModelResourceOption, u as NexraBillingCurrency, v as NexraModelOperation, w as NexraModelSpec, x as NexraModelSpecFilter, y as NexraQuote, z as NexraSalePrice, A as NormalizedUsageV1, P as PriceEvaluation, D as PriceEvaluationIssue, E as PriceEvaluationLine, G as PriceRule, U as UsageComponentEvidence, I as UsageEvidenceAssessment, K as UsageEvidenceStatus, L as allocateDiscountedPriceLines, O as assessUsageEvidence, Q as evaluatePriceRule, R as getModelSpec, S as jsonBody, V as listModelSpecs, W as queryString, X as sleep, Y as validateMeteringContract, Z as validateNormalizedUsage, _ as validatePriceRule } from './catalog-mytCeh5t.js';
+import { J as JsonObject, B as BillingMetric, a as JsonValue, N as NexraSettlement, C as CursorPage, H as HttpTransport, M as ModelSearchParams, T as TaskModelSummary, b as TaskModel, c as ModelSchema, d as CatalogClient, e as NexraClientOptions } from './index-mytCeh5t.js';
+export { f as BILLING_EXPORT_DIMENSIONS, g as BILLING_METRICS, h as CreateNexraQuoteRequest, F as FetchLike, i as JsonPrimitive, j as MeteredPriceRate, k as MeteredPriceRuleV1, l as MeteredUsageComponent, m as MeteringContract, n as MeteringKind, o as ModelCapabilitySummary, p as ModelDateVersion, q as ModelEndpointSummary, r as ModelModality, s as ModelResourceList, t as ModelResourceOption, u as NexraBillingCurrency, v as NexraModelOperation, w as NexraModelSpec, x as NexraModelSpecFilter, y as NexraQuote, z as NexraSalePrice, A as NormalizedUsageV1, P as PriceEvaluation, D as PriceEvaluationIssue, E as PriceEvaluationLine, G as PriceRule, U as UsageComponentEvidence, I as UsageEvidenceAssessment, K as UsageEvidenceStatus, L as allocateDiscountedPriceLines, O as assessUsageEvidence, Q as evaluatePriceRule, R as getModelSpec, S as jsonBody, V as listModelSpecs, W as queryString, X as sleep, Y as validateMeteringContract, Z as validateNormalizedUsage, _ as validatePriceRule } from './index-mytCeh5t.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';
 
 declare const MEDIA_KINDS: readonly ["image", "video", "audio", "document", "archive", "other"];

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   listModelSpecs,
   queryString,
   sleep
-} from "./chunk-IMJZBLDE.js";
+} from "./chunk-AV3GN4TV.js";
 import {
   ceilDecimal,
   multiplyDecimal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byte_fluffy/nexra-sdk",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "type": "module",
   "sideEffects": false,
   "repository": {
@@ -32,7 +32,7 @@
   },
   "scripts": {
     "generate": "bun scripts/generate-public-catalog.ts",
-    "build": "bun run generate && tsup src/index.ts src/catalog.ts src/decimal.ts --format esm --dts --dts-resolve --clean --out-dir dist --target es2022 --platform browser",
+    "build": "bun run generate && tsup",
     "test": "vitest run --root ../.. packages/sdk/tests",
     "prepack": "bun run build"
   },