@modelrelay/sdk 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(index_exports, {
   SDK_VERSION: () => SDK_VERSION,
   STAGING_BASE_URL: () => STAGING_BASE_URL,
   StopReasons: () => StopReasons,
+  TiersClient: () => TiersClient,
   TransportError: () => TransportError,
   isPublishableKey: () => isPublishableKey,
   mergeMetrics: () => mergeMetrics,
@@ -272,7 +273,7 @@ function isTokenReusable(token) {
 // package.json
 var package_default = {
   name: "@modelrelay/sdk",
-  version: "0.4.0",
+  version: "0.5.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",
@@ -917,6 +918,46 @@ var CustomersClient = class {
   }
 };
 
+// src/tiers.ts
+var TiersClient = class {
+  constructor(http, cfg) {
+    this.http = http;
+    this.apiKey = cfg.apiKey;
+  }
+  ensureApiKey() {
+    if (!this.apiKey || !this.apiKey.startsWith("mr_pk_") && !this.apiKey.startsWith("mr_sk_")) {
+      throw new ConfigError(
+        "API key (mr_pk_* or mr_sk_*) required for tier operations"
+      );
+    }
+  }
+  /**
+   * List all tiers in the project.
+   */
+  async list() {
+    this.ensureApiKey();
+    const response = await this.http.json("/tiers", {
+      method: "GET",
+      apiKey: this.apiKey
+    });
+    return response.tiers;
+  }
+  /**
+   * Get a tier by ID.
+   */
+  async get(tierId) {
+    this.ensureApiKey();
+    if (!tierId?.trim()) {
+      throw new ConfigError("tierId is required");
+    }
+    const response = await this.http.json(`/tiers/${tierId}`, {
+      method: "GET",
+      apiKey: this.apiKey
+    });
+    return response.tier;
+  }
+};
+
 // src/http.ts
 var HTTPClient = class {
   constructor(cfg) {
@@ -1289,6 +1330,9 @@ var ModelRelay = class {
     this.customers = new CustomersClient(http, {
       apiKey: cfg.key
     });
+    this.tiers = new TiersClient(http, {
+      apiKey: cfg.key
+    });
   }
 };
 function resolveBaseUrl(env, override) {
@@ -1315,6 +1359,7 @@ function resolveBaseUrl(env, override) {
   SDK_VERSION,
   STAGING_BASE_URL,
   StopReasons,
+  TiersClient,
   TransportError,
   isPublishableKey,
   mergeMetrics,

package/dist/index.d.cts

@@ -656,6 +656,50 @@ declare class CustomersClient {
     getSubscription(customerId: string): Promise<SubscriptionStatus>;
 }
 
+/**
+ * Billing interval for a tier.
+ */
+type PriceInterval = "month" | "year";
+/**
+ * Tier represents a pricing tier in a ModelRelay project.
+ */
+interface Tier {
+    id: string;
+    project_id: string;
+    tier_code: string;
+    display_name: string;
+    actions_limit: number;
+    token_limit: number;
+    stripe_price_id?: string;
+    price_amount?: number;
+    price_currency?: string;
+    price_interval?: PriceInterval;
+    trial_days?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface TiersClientConfig {
+    apiKey?: string;
+}
+/**
+ * TiersClient provides methods to query tiers in a project.
+ * Works with both publishable keys (mr_pk_*) and secret keys (mr_sk_*).
+ */
+declare class TiersClient {
+    private readonly http;
+    private readonly apiKey?;
+    constructor(http: HTTPClient, cfg: TiersClientConfig);
+    private ensureApiKey;
+    /**
+     * List all tiers in the project.
+     */
+    list(): Promise<Tier[]>;
+    /**
+     * Get a tier by ID.
+     */
+    get(tierId: string): Promise<Tier>;
+}
+
 type ErrorCategory = "config" | "transport" | "api";
 declare class ModelRelayError extends Error {
     category: ErrorCategory;
@@ -704,8 +748,9 @@ declare class ModelRelay {
     readonly chat: ChatClient;
     readonly auth: AuthClient;
     readonly customers: CustomersClient;
+    readonly tiers: TiersClient;
     readonly baseUrl: string;
     constructor(options: ModelRelayOptions);
 }
 
-export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, ConfigError, type Customer, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type Environment, type ErrorCategory, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type HttpRequestMetrics, type KnownModel, type KnownProvider, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, ModelRelayError, type ModelRelayOptions, Models, type NonEmptyArray, type Project, type ProviderId, Providers, type RequestContext, type RetryConfig, type RetryMetadata, SANDBOX_BASE_URL, SDK_VERSION, STAGING_BASE_URL, type StopReason, StopReasons, type StreamFirstTokenMetrics, type SubscriptionStatus, type TokenUsageMetrics, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeProvider, normalizeStopReason, parseErrorResponse, providerToString, stopReasonToString };
+export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, ConfigError, type Customer, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type Environment, type ErrorCategory, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type HttpRequestMetrics, type KnownModel, type KnownProvider, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, ModelRelayError, type ModelRelayOptions, Models, type NonEmptyArray, type PriceInterval, type Project, type ProviderId, Providers, type RequestContext, type RetryConfig, type RetryMetadata, SANDBOX_BASE_URL, SDK_VERSION, STAGING_BASE_URL, type StopReason, StopReasons, type StreamFirstTokenMetrics, type SubscriptionStatus, type Tier, TiersClient, type TokenUsageMetrics, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeProvider, normalizeStopReason, parseErrorResponse, providerToString, stopReasonToString };

package/dist/index.d.ts

@@ -656,6 +656,50 @@ declare class CustomersClient {
     getSubscription(customerId: string): Promise<SubscriptionStatus>;
 }
 
+/**
+ * Billing interval for a tier.
+ */
+type PriceInterval = "month" | "year";
+/**
+ * Tier represents a pricing tier in a ModelRelay project.
+ */
+interface Tier {
+    id: string;
+    project_id: string;
+    tier_code: string;
+    display_name: string;
+    actions_limit: number;
+    token_limit: number;
+    stripe_price_id?: string;
+    price_amount?: number;
+    price_currency?: string;
+    price_interval?: PriceInterval;
+    trial_days?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface TiersClientConfig {
+    apiKey?: string;
+}
+/**
+ * TiersClient provides methods to query tiers in a project.
+ * Works with both publishable keys (mr_pk_*) and secret keys (mr_sk_*).
+ */
+declare class TiersClient {
+    private readonly http;
+    private readonly apiKey?;
+    constructor(http: HTTPClient, cfg: TiersClientConfig);
+    private ensureApiKey;
+    /**
+     * List all tiers in the project.
+     */
+    list(): Promise<Tier[]>;
+    /**
+     * Get a tier by ID.
+     */
+    get(tierId: string): Promise<Tier>;
+}
+
 type ErrorCategory = "config" | "transport" | "api";
 declare class ModelRelayError extends Error {
     category: ErrorCategory;
@@ -704,8 +748,9 @@ declare class ModelRelay {
     readonly chat: ChatClient;
     readonly auth: AuthClient;
     readonly customers: CustomersClient;
+    readonly tiers: TiersClient;
     readonly baseUrl: string;
     constructor(options: ModelRelayOptions);
 }
 
-export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, ConfigError, type Customer, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type Environment, type ErrorCategory, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type HttpRequestMetrics, type KnownModel, type KnownProvider, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, ModelRelayError, type ModelRelayOptions, Models, type NonEmptyArray, type Project, type ProviderId, Providers, type RequestContext, type RetryConfig, type RetryMetadata, SANDBOX_BASE_URL, SDK_VERSION, STAGING_BASE_URL, type StopReason, StopReasons, type StreamFirstTokenMetrics, type SubscriptionStatus, type TokenUsageMetrics, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeProvider, normalizeStopReason, parseErrorResponse, providerToString, stopReasonToString };
+export { type APIChatResponse, type APIChatUsage, type APICheckoutSession, type APICustomerRef, APIError, type APIFrontendToken, type APIKey, AuthClient, ChatClient, type ChatCompletionCreateParams, type ChatCompletionEvent, type ChatCompletionResponse, ChatCompletionsStream, type ChatEventType, type ChatMessage, type CheckoutSession, type CheckoutSessionRequest, ConfigError, type Customer, type CustomerCreateRequest, type CustomerMetadata, type CustomerUpsertRequest, CustomersClient, DEFAULT_BASE_URL, DEFAULT_CLIENT_HEADER, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, type Environment, type ErrorCategory, type FieldError, type FrontendCustomer, type FrontendToken, type FrontendTokenRequest, type HttpRequestMetrics, type KnownModel, type KnownProvider, type KnownStopReason, type MessageDeltaData, type MessageStartData, type MessageStopData, type MetricsCallbacks, type ModelId, ModelRelay, ModelRelayError, type ModelRelayOptions, Models, type NonEmptyArray, type PriceInterval, type Project, type ProviderId, Providers, type RequestContext, type RetryConfig, type RetryMetadata, SANDBOX_BASE_URL, SDK_VERSION, STAGING_BASE_URL, type StopReason, StopReasons, type StreamFirstTokenMetrics, type SubscriptionStatus, type Tier, TiersClient, type TokenUsageMetrics, type TraceCallbacks, TransportError, type TransportErrorKind, type Usage, type UsageSummary, isPublishableKey, mergeMetrics, mergeTrace, modelToString, normalizeModelId, normalizeProvider, normalizeStopReason, parseErrorResponse, providerToString, stopReasonToString };

package/dist/index.js

@@ -218,7 +218,7 @@ function isTokenReusable(token) {
 // package.json
 var package_default = {
   name: "@modelrelay/sdk",
-  version: "0.4.0",
+  version: "0.5.0",
   description: "TypeScript SDK for the ModelRelay API",
   type: "module",
   main: "dist/index.cjs",
@@ -863,6 +863,46 @@ var CustomersClient = class {
   }
 };
 
+// src/tiers.ts
+var TiersClient = class {
+  constructor(http, cfg) {
+    this.http = http;
+    this.apiKey = cfg.apiKey;
+  }
+  ensureApiKey() {
+    if (!this.apiKey || !this.apiKey.startsWith("mr_pk_") && !this.apiKey.startsWith("mr_sk_")) {
+      throw new ConfigError(
+        "API key (mr_pk_* or mr_sk_*) required for tier operations"
+      );
+    }
+  }
+  /**
+   * List all tiers in the project.
+   */
+  async list() {
+    this.ensureApiKey();
+    const response = await this.http.json("/tiers", {
+      method: "GET",
+      apiKey: this.apiKey
+    });
+    return response.tiers;
+  }
+  /**
+   * Get a tier by ID.
+   */
+  async get(tierId) {
+    this.ensureApiKey();
+    if (!tierId?.trim()) {
+      throw new ConfigError("tierId is required");
+    }
+    const response = await this.http.json(`/tiers/${tierId}`, {
+      method: "GET",
+      apiKey: this.apiKey
+    });
+    return response.tier;
+  }
+};
+
 // src/http.ts
 var HTTPClient = class {
   constructor(cfg) {
@@ -1235,6 +1275,9 @@ var ModelRelay = class {
     this.customers = new CustomersClient(http, {
       apiKey: cfg.key
     });
+    this.tiers = new TiersClient(http, {
+      apiKey: cfg.key
+    });
   }
 };
 function resolveBaseUrl(env, override) {
@@ -1260,6 +1303,7 @@ export {
   SDK_VERSION,
   STAGING_BASE_URL,
   StopReasons,
+  TiersClient,
   TransportError,
   isPublishableKey,
   mergeMetrics,

package/package.json

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