@modelrelay/sdk 0.17.0 → 0.19.0

package/dist/index.cjs

@@ -347,7 +347,7 @@ function isTokenReusable(token) {
 // package.json
 var package_default = {
   name: "@modelrelay/sdk",
-  version: "0.17.0",
+  version: "0.19.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",
@@ -2026,6 +2026,13 @@ var TiersClient = class {
       );
     }
   }
+  ensureSecretKey() {
+    if (!this.apiKey || !this.apiKey.startsWith("mr_sk_")) {
+      throw new ConfigError(
+        "Secret key (mr_sk_*) required for checkout operations"
+      );
+    }
+  }
   /**
    * List all tiers in the project.
    */
@@ -2051,6 +2058,40 @@ var TiersClient = class {
     });
     return response.tier;
   }
+  /**
+   * Create a Stripe checkout session for a tier (Stripe-first flow).
+   *
+   * 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 redirect URLs
+   * @returns Checkout session with Stripe URL
+   */
+  async checkout(tierId, request) {
+    this.ensureSecretKey();
+    if (!tierId?.trim()) {
+      throw new ConfigError("tierId is required");
+    }
+    if (!request.success_url?.trim()) {
+      throw new ConfigError("success_url is required");
+    }
+    if (!request.cancel_url?.trim()) {
+      throw new ConfigError("cancel_url is required");
+    }
+    return await this.http.json(
+      `/tiers/${tierId}/checkout`,
+      {
+        method: "POST",
+        apiKey: this.apiKey,
+        body: request
+      }
+    );
+  }
 };
 
 // src/http.ts

package/dist/index.d.cts

@@ -908,6 +908,21 @@ interface Tier {
     created_at: string;
     updated_at: string;
 }
+/**
+ * Request to create a tier checkout session (Stripe-first flow).
+ * Stripe collects the customer's email during checkout.
+ */
+interface TierCheckoutRequest {
+    success_url: string;
+    cancel_url: string;
+}
+/**
+ * Tier checkout session response.
+ */
+interface TierCheckoutSession {
+    session_id: string;
+    url: string;
+}
 interface TiersClientConfig {
     apiKey?: string;
 }
@@ -920,6 +935,7 @@ declare class TiersClient {
     private readonly apiKey?;
     constructor(http: HTTPClient, cfg: TiersClientConfig);
     private ensureApiKey;
+    private ensureSecretKey;
     /**
      * List all tiers in the project.
      */
@@ -928,6 +944,21 @@ declare class TiersClient {
      * Get a tier by ID.
      */
     get(tierId: string): Promise<Tier>;
+    /**
+     * Create a Stripe checkout session for a tier (Stripe-first flow).
+     *
+     * 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 redirect URLs
+     * @returns Checkout session with Stripe URL
+     */
+    checkout(tierId: string, request: TierCheckoutRequest): Promise<TierCheckoutSession>;
 }
 
 /**
@@ -1430,4 +1461,4 @@ declare class ModelRelay {
     constructor(options: ModelRelayOptions);
 }
 
-export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, type AuthHeaders, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, type CodeExecConfig, ConfigError, type Customer, type CustomerClaimRequest, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type ErrorCategory, type ErrorCode, ErrorCodes, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type FunctionCall, type FunctionCallDelta, type FunctionTool, type HttpRequestMetrics, type JsonSchemaOptions, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, type ModelRelayBaseOptions, ModelRelayError, type ModelRelayKeyOptions, type ModelRelayOptions, type ModelRelayOptionsLegacy, type ModelRelayTokenOptions, type NonEmptyArray, type PriceInterval, type Project, type ProviderId, type RequestContext, type ResponseFormat, type ResponseFormatType, ResponseFormatTypes, type ResponseJSONSchemaFormat, type RetryConfig, type RetryMetadata, type RetryOptions, SDK_VERSION, type Schema, type StopReason, StopReasons, type StreamFirstTokenMetrics, type StructuredJSONEvent, type StructuredJSONRecordType, StructuredJSONStream, type SubscriptionStatus, type Tier, TiersClient, type TokenUsageMetrics, type Tool, ToolArgsError, type ToolCall, ToolCallAccumulator, type ToolCallDelta, type ToolChoice, type ToolChoiceType, ToolChoiceTypes, type ToolExecutionResult, type ToolHandler, ToolRegistry, type ToolType, ToolTypes, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, type WebSearchConfig, type WebToolMode, WebToolModes, type XSearchConfig, type ZodLikeSchema, assistantMessageWithToolCalls, createAccessTokenAuth, createApiKeyAuth, createAssistantMessage, createFunctionCall, createFunctionTool, createFunctionToolFromSchema, createRetryMessages, createSystemMessage, createToolCall, createUsage, createUserMessage, createWebTool, executeWithRetry, firstToolCall, formatToolErrorForModel, getRetryableErrors, hasRetryableErrors, hasToolCalls, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeStopReason, parseErrorResponse, parseToolArgs, parseToolArgsRaw, respondToToolCall, stopReasonToString, toolChoiceAuto, toolChoiceNone, toolChoiceRequired, toolResultMessage, tryParseToolArgs, zodToJsonSchema };
+export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, type AuthHeaders, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, type CodeExecConfig, ConfigError, type Customer, type CustomerClaimRequest, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type ErrorCategory, type ErrorCode, ErrorCodes, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type FunctionCall, type FunctionCallDelta, type FunctionTool, type HttpRequestMetrics, type JsonSchemaOptions, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, type ModelRelayBaseOptions, ModelRelayError, type ModelRelayKeyOptions, type ModelRelayOptions, type ModelRelayOptionsLegacy, type ModelRelayTokenOptions, type NonEmptyArray, type PriceInterval, type Project, type ProviderId, type RequestContext, type ResponseFormat, type ResponseFormatType, ResponseFormatTypes, type ResponseJSONSchemaFormat, type RetryConfig, type RetryMetadata, type RetryOptions, SDK_VERSION, type Schema, type StopReason, StopReasons, type StreamFirstTokenMetrics, type StructuredJSONEvent, type StructuredJSONRecordType, StructuredJSONStream, type SubscriptionStatus, type Tier, type TierCheckoutRequest, type TierCheckoutSession, TiersClient, type TokenUsageMetrics, type Tool, ToolArgsError, type ToolCall, ToolCallAccumulator, type ToolCallDelta, type ToolChoice, type ToolChoiceType, ToolChoiceTypes, type ToolExecutionResult, type ToolHandler, ToolRegistry, type ToolType, ToolTypes, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, type WebSearchConfig, type WebToolMode, WebToolModes, type XSearchConfig, type ZodLikeSchema, assistantMessageWithToolCalls, createAccessTokenAuth, createApiKeyAuth, createAssistantMessage, createFunctionCall, createFunctionTool, createFunctionToolFromSchema, createRetryMessages, createSystemMessage, createToolCall, createUsage, createUserMessage, createWebTool, executeWithRetry, firstToolCall, formatToolErrorForModel, getRetryableErrors, hasRetryableErrors, hasToolCalls, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeStopReason, parseErrorResponse, parseToolArgs, parseToolArgsRaw, respondToToolCall, stopReasonToString, toolChoiceAuto, toolChoiceNone, toolChoiceRequired, toolResultMessage, tryParseToolArgs, zodToJsonSchema };

package/dist/index.d.ts

@@ -908,6 +908,21 @@ interface Tier {
     created_at: string;
     updated_at: string;
 }
+/**
+ * Request to create a tier checkout session (Stripe-first flow).
+ * Stripe collects the customer's email during checkout.
+ */
+interface TierCheckoutRequest {
+    success_url: string;
+    cancel_url: string;
+}
+/**
+ * Tier checkout session response.
+ */
+interface TierCheckoutSession {
+    session_id: string;
+    url: string;
+}
 interface TiersClientConfig {
     apiKey?: string;
 }
@@ -920,6 +935,7 @@ declare class TiersClient {
     private readonly apiKey?;
     constructor(http: HTTPClient, cfg: TiersClientConfig);
     private ensureApiKey;
+    private ensureSecretKey;
     /**
      * List all tiers in the project.
      */
@@ -928,6 +944,21 @@ declare class TiersClient {
      * Get a tier by ID.
      */
     get(tierId: string): Promise<Tier>;
+    /**
+     * Create a Stripe checkout session for a tier (Stripe-first flow).
+     *
+     * 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 redirect URLs
+     * @returns Checkout session with Stripe URL
+     */
+    checkout(tierId: string, request: TierCheckoutRequest): Promise<TierCheckoutSession>;
 }
 
 /**
@@ -1430,4 +1461,4 @@ declare class ModelRelay {
     constructor(options: ModelRelayOptions);
 }
 
-export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, type AuthHeaders, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, type CodeExecConfig, ConfigError, type Customer, type CustomerClaimRequest, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type ErrorCategory, type ErrorCode, ErrorCodes, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type FunctionCall, type FunctionCallDelta, type FunctionTool, type HttpRequestMetrics, type JsonSchemaOptions, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, type ModelRelayBaseOptions, ModelRelayError, type ModelRelayKeyOptions, type ModelRelayOptions, type ModelRelayOptionsLegacy, type ModelRelayTokenOptions, type NonEmptyArray, type PriceInterval, type Project, type ProviderId, type RequestContext, type ResponseFormat, type ResponseFormatType, ResponseFormatTypes, type ResponseJSONSchemaFormat, type RetryConfig, type RetryMetadata, type RetryOptions, SDK_VERSION, type Schema, type StopReason, StopReasons, type StreamFirstTokenMetrics, type StructuredJSONEvent, type StructuredJSONRecordType, StructuredJSONStream, type SubscriptionStatus, type Tier, TiersClient, type TokenUsageMetrics, type Tool, ToolArgsError, type ToolCall, ToolCallAccumulator, type ToolCallDelta, type ToolChoice, type ToolChoiceType, ToolChoiceTypes, type ToolExecutionResult, type ToolHandler, ToolRegistry, type ToolType, ToolTypes, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, type WebSearchConfig, type WebToolMode, WebToolModes, type XSearchConfig, type ZodLikeSchema, assistantMessageWithToolCalls, createAccessTokenAuth, createApiKeyAuth, createAssistantMessage, createFunctionCall, createFunctionTool, createFunctionToolFromSchema, createRetryMessages, createSystemMessage, createToolCall, createUsage, createUserMessage, createWebTool, executeWithRetry, firstToolCall, formatToolErrorForModel, getRetryableErrors, hasRetryableErrors, hasToolCalls, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeStopReason, parseErrorResponse, parseToolArgs, parseToolArgsRaw, respondToToolCall, stopReasonToString, toolChoiceAuto, toolChoiceNone, toolChoiceRequired, toolResultMessage, tryParseToolArgs, zodToJsonSchema };
+export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, type AuthHeaders, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, type CodeExecConfig, ConfigError, type Customer, type CustomerClaimRequest, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type ErrorCategory, type ErrorCode, ErrorCodes, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type FunctionCall, type FunctionCallDelta, type FunctionTool, type HttpRequestMetrics, type JsonSchemaOptions, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, type ModelRelayBaseOptions, ModelRelayError, type ModelRelayKeyOptions, type ModelRelayOptions, type ModelRelayOptionsLegacy, type ModelRelayTokenOptions, type NonEmptyArray, type PriceInterval, type Project, type ProviderId, type RequestContext, type ResponseFormat, type ResponseFormatType, ResponseFormatTypes, type ResponseJSONSchemaFormat, type RetryConfig, type RetryMetadata, type RetryOptions, SDK_VERSION, type Schema, type StopReason, StopReasons, type StreamFirstTokenMetrics, type StructuredJSONEvent, type StructuredJSONRecordType, StructuredJSONStream, type SubscriptionStatus, type Tier, type TierCheckoutRequest, type TierCheckoutSession, TiersClient, type TokenUsageMetrics, type Tool, ToolArgsError, type ToolCall, ToolCallAccumulator, type ToolCallDelta, type ToolChoice, type ToolChoiceType, ToolChoiceTypes, type ToolExecutionResult, type ToolHandler, ToolRegistry, type ToolType, ToolTypes, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, type WebSearchConfig, type WebToolMode, WebToolModes, type XSearchConfig, type ZodLikeSchema, assistantMessageWithToolCalls, createAccessTokenAuth, createApiKeyAuth, createAssistantMessage, createFunctionCall, createFunctionTool, createFunctionToolFromSchema, createRetryMessages, createSystemMessage, createToolCall, createUsage, createUserMessage, createWebTool, executeWithRetry, firstToolCall, formatToolErrorForModel, getRetryableErrors, hasRetryableErrors, hasToolCalls, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeStopReason, parseErrorResponse, parseToolArgs, parseToolArgsRaw, respondToToolCall, stopReasonToString, toolChoiceAuto, toolChoiceNone, toolChoiceRequired, toolResultMessage, tryParseToolArgs, zodToJsonSchema };

package/dist/index.js

@@ -261,7 +261,7 @@ function isTokenReusable(token) {
 // package.json
 var package_default = {
   name: "@modelrelay/sdk",
-  version: "0.17.0",
+  version: "0.19.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",
@@ -1940,6 +1940,13 @@ var TiersClient = class {
       );
     }
   }
+  ensureSecretKey() {
+    if (!this.apiKey || !this.apiKey.startsWith("mr_sk_")) {
+      throw new ConfigError(
+        "Secret key (mr_sk_*) required for checkout operations"
+      );
+    }
+  }
   /**
    * List all tiers in the project.
    */
@@ -1965,6 +1972,40 @@ var TiersClient = class {
     });
     return response.tier;
   }
+  /**
+   * Create a Stripe checkout session for a tier (Stripe-first flow).
+   *
+   * 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 redirect URLs
+   * @returns Checkout session with Stripe URL
+   */
+  async checkout(tierId, request) {
+    this.ensureSecretKey();
+    if (!tierId?.trim()) {
+      throw new ConfigError("tierId is required");
+    }
+    if (!request.success_url?.trim()) {
+      throw new ConfigError("success_url is required");
+    }
+    if (!request.cancel_url?.trim()) {
+      throw new ConfigError("cancel_url is required");
+    }
+    return await this.http.json(
+      `/tiers/${tierId}/checkout`,
+      {
+        method: "POST",
+        apiKey: this.apiKey,
+        body: request
+      }
+    );
+  }
 };
 
 // src/http.ts

package/package.json

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