@modelrelay/sdk 0.19.0 → 0.20.0

package/dist/index.cjs

@@ -96,7 +96,11 @@ var ErrorCodes = {
   SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
   INVALID_INPUT: "INVALID_INPUT",
   PAYMENT_REQUIRED: "PAYMENT_REQUIRED",
-  METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED"
+  METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED",
+  /** No tiers configured for the project - create a tier first. */
+  NO_TIERS: "NO_TIERS",
+  /** No free tier available for auto-provisioning - create a free tier or use checkout flow. */
+  NO_FREE_TIER: "NO_FREE_TIER"
 };
 var ModelRelayError = class extends Error {
   constructor(message, opts) {
@@ -165,6 +169,29 @@ var APIError = class extends ModelRelayError {
   isUnavailable() {
     return this.code === ErrorCodes.SERVICE_UNAVAILABLE;
   }
+  /**
+   * Returns true if the error indicates no tiers are configured.
+   * To resolve: create at least one tier in your project dashboard.
+   */
+  isNoTiers() {
+    return this.code === ErrorCodes.NO_TIERS;
+  }
+  /**
+   * Returns true if the error indicates no free tier is available for auto-provisioning.
+   * To resolve: either create a free tier for automatic customer creation,
+   * or use the checkout flow to create paying customers first.
+   */
+  isNoFreeTier() {
+    return this.code === ErrorCodes.NO_FREE_TIER;
+  }
+  /**
+   * Returns true if this is a customer provisioning error (NO_TIERS or NO_FREE_TIER).
+   * These errors occur when calling frontendToken() with a customer that doesn't exist
+   * and automatic provisioning cannot complete.
+   */
+  isProvisioningError() {
+    return this.isNoTiers() || this.isNoFreeTier();
+  }
 };
 async function parseErrorResponse(response, retries) {
   const requestId = response.headers.get("X-ModelRelay-Chat-Request-Id") || response.headers.get("X-Request-Id") || void 0;
@@ -347,7 +374,7 @@ function isTokenReusable(token) {
 // package.json
 var package_default = {
   name: "@modelrelay/sdk",
-  version: "0.19.0",
+  version: "0.20.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",

package/dist/index.d.cts

@@ -977,6 +977,10 @@ declare const ErrorCodes: {
     readonly INVALID_INPUT: "INVALID_INPUT";
     readonly PAYMENT_REQUIRED: "PAYMENT_REQUIRED";
     readonly METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED";
+    /** No tiers configured for the project - create a tier first. */
+    readonly NO_TIERS: "NO_TIERS";
+    /** No free tier available for auto-provisioning - create a free tier or use checkout flow. */
+    readonly NO_FREE_TIER: "NO_FREE_TIER";
 };
 type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
 type ErrorCategory = "config" | "transport" | "api";
@@ -1032,6 +1036,23 @@ declare class APIError extends ModelRelayError {
     isForbidden(): boolean;
     /** Returns true if the error is a service unavailable error. */
     isUnavailable(): boolean;
+    /**
+     * Returns true if the error indicates no tiers are configured.
+     * To resolve: create at least one tier in your project dashboard.
+     */
+    isNoTiers(): boolean;
+    /**
+     * Returns true if the error indicates no free tier is available for auto-provisioning.
+     * To resolve: either create a free tier for automatic customer creation,
+     * or use the checkout flow to create paying customers first.
+     */
+    isNoFreeTier(): boolean;
+    /**
+     * Returns true if this is a customer provisioning error (NO_TIERS or NO_FREE_TIER).
+     * These errors occur when calling frontendToken() with a customer that doesn't exist
+     * and automatic provisioning cannot complete.
+     */
+    isProvisioningError(): boolean;
 }
 declare function parseErrorResponse(response: Response, retries?: RetryMetadata): Promise<APIError>;
 

package/dist/index.d.ts

@@ -977,6 +977,10 @@ declare const ErrorCodes: {
     readonly INVALID_INPUT: "INVALID_INPUT";
     readonly PAYMENT_REQUIRED: "PAYMENT_REQUIRED";
     readonly METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED";
+    /** No tiers configured for the project - create a tier first. */
+    readonly NO_TIERS: "NO_TIERS";
+    /** No free tier available for auto-provisioning - create a free tier or use checkout flow. */
+    readonly NO_FREE_TIER: "NO_FREE_TIER";
 };
 type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
 type ErrorCategory = "config" | "transport" | "api";
@@ -1032,6 +1036,23 @@ declare class APIError extends ModelRelayError {
     isForbidden(): boolean;
     /** Returns true if the error is a service unavailable error. */
     isUnavailable(): boolean;
+    /**
+     * Returns true if the error indicates no tiers are configured.
+     * To resolve: create at least one tier in your project dashboard.
+     */
+    isNoTiers(): boolean;
+    /**
+     * Returns true if the error indicates no free tier is available for auto-provisioning.
+     * To resolve: either create a free tier for automatic customer creation,
+     * or use the checkout flow to create paying customers first.
+     */
+    isNoFreeTier(): boolean;
+    /**
+     * Returns true if this is a customer provisioning error (NO_TIERS or NO_FREE_TIER).
+     * These errors occur when calling frontendToken() with a customer that doesn't exist
+     * and automatic provisioning cannot complete.
+     */
+    isProvisioningError(): boolean;
 }
 declare function parseErrorResponse(response: Response, retries?: RetryMetadata): Promise<APIError>;
 

package/dist/index.js

@@ -10,7 +10,11 @@ var ErrorCodes = {
   SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
   INVALID_INPUT: "INVALID_INPUT",
   PAYMENT_REQUIRED: "PAYMENT_REQUIRED",
-  METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED"
+  METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED",
+  /** No tiers configured for the project - create a tier first. */
+  NO_TIERS: "NO_TIERS",
+  /** No free tier available for auto-provisioning - create a free tier or use checkout flow. */
+  NO_FREE_TIER: "NO_FREE_TIER"
 };
 var ModelRelayError = class extends Error {
   constructor(message, opts) {
@@ -79,6 +83,29 @@ var APIError = class extends ModelRelayError {
   isUnavailable() {
     return this.code === ErrorCodes.SERVICE_UNAVAILABLE;
   }
+  /**
+   * Returns true if the error indicates no tiers are configured.
+   * To resolve: create at least one tier in your project dashboard.
+   */
+  isNoTiers() {
+    return this.code === ErrorCodes.NO_TIERS;
+  }
+  /**
+   * Returns true if the error indicates no free tier is available for auto-provisioning.
+   * To resolve: either create a free tier for automatic customer creation,
+   * or use the checkout flow to create paying customers first.
+   */
+  isNoFreeTier() {
+    return this.code === ErrorCodes.NO_FREE_TIER;
+  }
+  /**
+   * Returns true if this is a customer provisioning error (NO_TIERS or NO_FREE_TIER).
+   * These errors occur when calling frontendToken() with a customer that doesn't exist
+   * and automatic provisioning cannot complete.
+   */
+  isProvisioningError() {
+    return this.isNoTiers() || this.isNoFreeTier();
+  }
 };
 async function parseErrorResponse(response, retries) {
   const requestId = response.headers.get("X-ModelRelay-Chat-Request-Id") || response.headers.get("X-Request-Id") || void 0;
@@ -261,7 +288,7 @@ function isTokenReusable(token) {
 // package.json
 var package_default = {
   name: "@modelrelay/sdk",
-  version: "0.19.0",
+  version: "0.20.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@modelrelay/sdk",
-  "version": "0.19.0",
+  "version": "0.20.0",
 	"description": "TypeScript SDK for the ModelRelay API",
 	"type": "module",
 	"main": "dist/index.cjs",