@modelrelay/sdk 0.18.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.18.0",
+  version: "0.20.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",
@@ -2061,14 +2088,15 @@ var TiersClient = class {
   /**
    * Create a Stripe checkout session for a tier (Stripe-first flow).
    *
-   * This enables users to subscribe before authenticating. After checkout
-   * completes, a customer record is created with the provided email. The
-   * customer can later be linked to an identity via POST /customers/claim.
+   * This enables users to subscribe before authenticating. Stripe collects
+   * the customer's email during checkout. After checkout completes, a
+   * customer record is created with the email from Stripe. The customer
+   * can later be linked to an identity via POST /customers/claim.
    *
    * Requires a secret key (mr_sk_*).
    *
    * @param tierId - The tier ID to create a checkout session for
-   * @param request - Checkout session request with email and redirect URLs
+   * @param request - Checkout session request with redirect URLs
    * @returns Checkout session with Stripe URL
    */
   async checkout(tierId, request) {
@@ -2076,9 +2104,6 @@ var TiersClient = class {
     if (!tierId?.trim()) {
       throw new ConfigError("tierId is required");
     }
-    if (!request.email?.trim()) {
-      throw new ConfigError("email is required");
-    }
     if (!request.success_url?.trim()) {
       throw new ConfigError("success_url is required");
     }

package/dist/index.d.cts

@@ -910,9 +910,9 @@ interface Tier {
 }
 /**
  * Request to create a tier checkout session (Stripe-first flow).
+ * Stripe collects the customer's email during checkout.
  */
 interface TierCheckoutRequest {
-    email: string;
     success_url: string;
     cancel_url: string;
 }
@@ -947,14 +947,15 @@ declare class TiersClient {
     /**
      * Create a Stripe checkout session for a tier (Stripe-first flow).
      *
-     * This enables users to subscribe before authenticating. After checkout
-     * completes, a customer record is created with the provided email. The
-     * customer can later be linked to an identity via POST /customers/claim.
+     * This enables users to subscribe before authenticating. Stripe collects
+     * the customer's email during checkout. After checkout completes, a
+     * customer record is created with the email from Stripe. The customer
+     * can later be linked to an identity via POST /customers/claim.
      *
      * Requires a secret key (mr_sk_*).
      *
      * @param tierId - The tier ID to create a checkout session for
-     * @param request - Checkout session request with email and redirect URLs
+     * @param request - Checkout session request with redirect URLs
      * @returns Checkout session with Stripe URL
      */
     checkout(tierId: string, request: TierCheckoutRequest): Promise<TierCheckoutSession>;
@@ -976,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";
@@ -1031,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

@@ -910,9 +910,9 @@ interface Tier {
 }
 /**
  * Request to create a tier checkout session (Stripe-first flow).
+ * Stripe collects the customer's email during checkout.
  */
 interface TierCheckoutRequest {
-    email: string;
     success_url: string;
     cancel_url: string;
 }
@@ -947,14 +947,15 @@ declare class TiersClient {
     /**
      * Create a Stripe checkout session for a tier (Stripe-first flow).
      *
-     * This enables users to subscribe before authenticating. After checkout
-     * completes, a customer record is created with the provided email. The
-     * customer can later be linked to an identity via POST /customers/claim.
+     * This enables users to subscribe before authenticating. Stripe collects
+     * the customer's email during checkout. After checkout completes, a
+     * customer record is created with the email from Stripe. The customer
+     * can later be linked to an identity via POST /customers/claim.
      *
      * Requires a secret key (mr_sk_*).
      *
      * @param tierId - The tier ID to create a checkout session for
-     * @param request - Checkout session request with email and redirect URLs
+     * @param request - Checkout session request with redirect URLs
      * @returns Checkout session with Stripe URL
      */
     checkout(tierId: string, request: TierCheckoutRequest): Promise<TierCheckoutSession>;
@@ -976,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";
@@ -1031,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.18.0",
+  version: "0.20.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",
@@ -1975,14 +2002,15 @@ var TiersClient = class {
   /**
    * Create a Stripe checkout session for a tier (Stripe-first flow).
    *
-   * This enables users to subscribe before authenticating. After checkout
-   * completes, a customer record is created with the provided email. The
-   * customer can later be linked to an identity via POST /customers/claim.
+   * This enables users to subscribe before authenticating. Stripe collects
+   * the customer's email during checkout. After checkout completes, a
+   * customer record is created with the email from Stripe. The customer
+   * can later be linked to an identity via POST /customers/claim.
    *
    * Requires a secret key (mr_sk_*).
    *
    * @param tierId - The tier ID to create a checkout session for
-   * @param request - Checkout session request with email and redirect URLs
+   * @param request - Checkout session request with redirect URLs
    * @returns Checkout session with Stripe URL
    */
   async checkout(tierId, request) {
@@ -1990,9 +2018,6 @@ var TiersClient = class {
     if (!tierId?.trim()) {
       throw new ConfigError("tierId is required");
     }
-    if (!request.email?.trim()) {
-      throw new ConfigError("email is required");
-    }
     if (!request.success_url?.trim()) {
       throw new ConfigError("success_url is required");
     }

package/package.json

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