@codetunezstudios/token-kit 0.1.0-beta.1 → 0.1.0-beta.3

package/README.md

@@ -15,7 +15,7 @@ token-kit enables developers to integrate LLM features into their applications u
 
 - **Simple API** — Intuitive methods for chat completions
 - **TypeScript First** — Full type safety and IntelliSense support
-- **Multiple Models** — Support for GPT-3.5, GPT-4, GPT-4 Turbo (more coming)
+- **Multiple Models** — Support for Claude, GPT-4o, Amazon Nova (more coming)
 - **Token Management** — Built-in balance checking and validation
 - **Error Handling** — Comprehensive typed error classes
 - **Lightweight** — Single runtime dependency (axios)
@@ -79,7 +79,7 @@ const res = await tk.chat('user_token', [
   TokenKit.system('You are a helpful assistant.'),
   TokenKit.user('Explain quantum computing simply.'),
 ], {
-  model: 'gpt-4',
+  model: 'gpt-4o',
   maxTokens: 200,
   temperature: 0.8,
 });
@@ -89,7 +89,7 @@ const res = await tk.chat('user_token', [
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `model` | `string` | `gpt-3.5-turbo` | LLM model to use |
+| `model` | `string` | `gpt-4o-mini` | LLM model to use |
 | `maxTokens` | `number` | `500` | Max tokens in response |
 | `temperature` | `number` | `0.7` | Randomness (0–2) |
 
@@ -144,7 +144,7 @@ List available LLM models.
 
 ```typescript
 const models = await tk.getModels();
-// ['gpt-3.5-turbo', 'gpt-4', 'gpt-4-turbo']
+// ['gpt-4o-mini', 'gpt-4o', 'claude-3.5-haiku', 'claude-sonnet-4', 'nova-micro', 'nova-lite']
 ```
 
 ### Helper Methods
@@ -213,9 +213,12 @@ Different models consume tokens at different rates:
 
 | Model | Rate | 1,000 TK tokens = |
 |-------|------|-------------------|
-| GPT-3.5 Turbo | 1.0x | 1,000 LLM tokens |
-| GPT-4 Turbo | 2.0x | 500 LLM tokens |
-| GPT-4 | 3.0x | 333 LLM tokens |
+| GPT-4o Mini | 1.0x | 1,000 LLM tokens |
+| Claude 3.5 Haiku | 1.0x | 1,000 LLM tokens |
+| Amazon Nova Micro | 1.0x | 1,000 LLM tokens |
+| Amazon Nova Lite | 1.0x | 1,000 LLM tokens |
+| GPT-4o | 2.0x | 500 LLM tokens |
+| Claude Sonnet 4 | 3.0x | 333 LLM tokens |
 
 See [token-kit.com](https://token-kit.com) for current package pricing and details.
 

package/dist/index.d.mts

@@ -8,7 +8,7 @@ interface Message {
     content: string;
 }
 interface ChatOptions {
-    /** LLM model to use (default: 'gpt-3.5-turbo') */
+    /** LLM model to use (default: 'gpt-4o-mini') */
     model?: string;
     /** Maximum tokens in response (default: 500) */
     maxTokens?: number;
@@ -86,10 +86,28 @@ declare class TokenKitAPIError extends Error implements TokenKitError {
     details?: unknown;
     constructor(message: string, code: string, statusCode?: number, details?: unknown);
 }
+/**
+ * Named deployment environments.
+ * Maps to the canonical API Gateway URLs for each environment.
+ * Use `baseUrl` to override for self-hosted or custom deployments.
+ */
+type TokenKitEnvironment = 'production' | 'staging' | 'development';
+/** Canonical base URLs per environment — exported for reference */
+declare const ENVIRONMENT_URLS: Record<TokenKitEnvironment, string>;
 interface TokenKitConfig {
     /** Developer API key */
     apiKey: string;
-    /** API Gateway base URL (default: https://api.token-kit.com) */
+    /**
+     * Named environment shorthand. Resolves to the canonical API URL.
+     * Ignored when `baseUrl` is also provided (baseUrl takes precedence).
+     * Defaults to `'production'` when neither is set.
+     */
+    environment?: TokenKitEnvironment;
+    /**
+     * Explicit API Gateway base URL.
+     * Use this for self-hosted deployments or local development.
+     * Takes precedence over `environment`.
+     */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 60000) */
     timeout?: number;
@@ -122,7 +140,11 @@ declare class TokenKit {
      *
      * @param config - Configuration options
      * @param config.apiKey - Your developer API key
-     * @param config.baseUrl - API base URL (optional, defaults to production)
+     * @param config.environment - Target environment: 'production' | 'staging' | 'development'
+     *   Resolves to the canonical API URL for that environment.
+     *   Defaults to 'production'. Ignored when `baseUrl` is also set.
+     * @param config.baseUrl - Explicit API base URL — overrides `environment`.
+     *   Use for self-hosted deployments or local tunnels.
      * @param config.timeout - Request timeout in ms (optional, defaults to 60000)
      */
     constructor(config: TokenKitConfig);
@@ -159,7 +181,7 @@ declare class TokenKit {
      *   { role: 'system', content: 'You are a helpful assistant.' },
      *   { role: 'user', content: 'Hello!' }
      * ], {
-     *   model: 'gpt-4',
+     *   model: 'gpt-4o',
      *   maxTokens: 200,
      *   temperature: 0.8
      * });
@@ -200,9 +222,9 @@ declare class TokenKit {
      *
      * @example
      * ```typescript
-     * const models = await tokenKit.getModels();
+     * const response = await tokenKit.getModels();
      * console.log('Available models:', models);
-     * // ['gpt-3.5-turbo', 'gpt-4', 'gpt-4-turbo']
+     * // ['claude-3.5-haiku', 'claude-sonnet-4', 'nova-micro', 'nova-lite', 'gpt-4o', 'gpt-4o-mini']
      * ```
      */
     getModels(): Promise<string[]>;
@@ -229,4 +251,4 @@ declare class TokenKit {
     static assistant(content: string): Message;
 }
 
-export { type ChatOptions, type ChatResponse, type Message, type MessageRole, type ModelInfo, type ModelsResponse, TokenKit, TokenKitAPIError, type TokenKitConfig, type TokenValidationResponse, TokenKit as default };
+export { type ChatOptions, type ChatResponse, ENVIRONMENT_URLS, type Message, type MessageRole, type ModelInfo, type ModelsResponse, TokenKit, TokenKitAPIError, type TokenKitConfig, type TokenKitEnvironment, type TokenValidationResponse, TokenKit as default };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ interface Message {
     content: string;
 }
 interface ChatOptions {
-    /** LLM model to use (default: 'gpt-3.5-turbo') */
+    /** LLM model to use (default: 'gpt-4o-mini') */
     model?: string;
     /** Maximum tokens in response (default: 500) */
     maxTokens?: number;
@@ -86,10 +86,28 @@ declare class TokenKitAPIError extends Error implements TokenKitError {
     details?: unknown;
     constructor(message: string, code: string, statusCode?: number, details?: unknown);
 }
+/**
+ * Named deployment environments.
+ * Maps to the canonical API Gateway URLs for each environment.
+ * Use `baseUrl` to override for self-hosted or custom deployments.
+ */
+type TokenKitEnvironment = 'production' | 'staging' | 'development';
+/** Canonical base URLs per environment — exported for reference */
+declare const ENVIRONMENT_URLS: Record<TokenKitEnvironment, string>;
 interface TokenKitConfig {
     /** Developer API key */
     apiKey: string;
-    /** API Gateway base URL (default: https://api.token-kit.com) */
+    /**
+     * Named environment shorthand. Resolves to the canonical API URL.
+     * Ignored when `baseUrl` is also provided (baseUrl takes precedence).
+     * Defaults to `'production'` when neither is set.
+     */
+    environment?: TokenKitEnvironment;
+    /**
+     * Explicit API Gateway base URL.
+     * Use this for self-hosted deployments or local development.
+     * Takes precedence over `environment`.
+     */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 60000) */
     timeout?: number;
@@ -122,7 +140,11 @@ declare class TokenKit {
      *
      * @param config - Configuration options
      * @param config.apiKey - Your developer API key
-     * @param config.baseUrl - API base URL (optional, defaults to production)
+     * @param config.environment - Target environment: 'production' | 'staging' | 'development'
+     *   Resolves to the canonical API URL for that environment.
+     *   Defaults to 'production'. Ignored when `baseUrl` is also set.
+     * @param config.baseUrl - Explicit API base URL — overrides `environment`.
+     *   Use for self-hosted deployments or local tunnels.
      * @param config.timeout - Request timeout in ms (optional, defaults to 60000)
      */
     constructor(config: TokenKitConfig);
@@ -159,7 +181,7 @@ declare class TokenKit {
      *   { role: 'system', content: 'You are a helpful assistant.' },
      *   { role: 'user', content: 'Hello!' }
      * ], {
-     *   model: 'gpt-4',
+     *   model: 'gpt-4o',
      *   maxTokens: 200,
      *   temperature: 0.8
      * });
@@ -200,9 +222,9 @@ declare class TokenKit {
      *
      * @example
      * ```typescript
-     * const models = await tokenKit.getModels();
+     * const response = await tokenKit.getModels();
      * console.log('Available models:', models);
-     * // ['gpt-3.5-turbo', 'gpt-4', 'gpt-4-turbo']
+     * // ['claude-3.5-haiku', 'claude-sonnet-4', 'nova-micro', 'nova-lite', 'gpt-4o', 'gpt-4o-mini']
      * ```
      */
     getModels(): Promise<string[]>;
@@ -229,4 +251,4 @@ declare class TokenKit {
     static assistant(content: string): Message;
 }
 
-export { type ChatOptions, type ChatResponse, type Message, type MessageRole, type ModelInfo, type ModelsResponse, TokenKit, TokenKitAPIError, type TokenKitConfig, type TokenValidationResponse, TokenKit as default };
+export { type ChatOptions, type ChatResponse, ENVIRONMENT_URLS, type Message, type MessageRole, type ModelInfo, type ModelsResponse, TokenKit, TokenKitAPIError, type TokenKitConfig, type TokenKitEnvironment, type TokenValidationResponse, TokenKit as default };

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ENVIRONMENT_URLS: () => ENVIRONMENT_URLS,
   TokenKit: () => TokenKit,
   TokenKitAPIError: () => TokenKitAPIError,
   default: () => index_default
@@ -50,6 +51,11 @@ var TokenKitAPIError = class extends Error {
     Error.captureStackTrace?.(this, this.constructor);
   }
 };
+var ENVIRONMENT_URLS = {
+  production: "https://api.token-kit.com/v1",
+  staging: "https://api-staging.token-kit.com/v1",
+  development: "https://api-dev.token-kit.com/v1"
+};
 
 // src/client.ts
 var TokenKitClient = class {
@@ -58,8 +64,9 @@ var TokenKitClient = class {
       throw new Error("API key is required");
     }
     this.apiKey = config.apiKey;
+    const baseURL = config.baseUrl ?? ENVIRONMENT_URLS[config.environment ?? "production"];
     this.client = import_axios.default.create({
-      baseURL: config.baseUrl || "https://api.token-kit.com/api/v1",
+      baseURL,
       timeout: config.timeout || 6e4,
       headers: {
         "Content-Type": "application/json",
@@ -203,7 +210,11 @@ var TokenKit = class {
    * 
    * @param config - Configuration options
    * @param config.apiKey - Your developer API key
-   * @param config.baseUrl - API base URL (optional, defaults to production)
+   * @param config.environment - Target environment: 'production' | 'staging' | 'development'
+   *   Resolves to the canonical API URL for that environment.
+   *   Defaults to 'production'. Ignored when `baseUrl` is also set.
+   * @param config.baseUrl - Explicit API base URL — overrides `environment`.
+   *   Use for self-hosted deployments or local tunnels.
    * @param config.timeout - Request timeout in ms (optional, defaults to 60000)
    */
   constructor(config) {
@@ -245,7 +256,7 @@ var TokenKit = class {
    *   { role: 'system', content: 'You are a helpful assistant.' },
    *   { role: 'user', content: 'Hello!' }
    * ], {
-   *   model: 'gpt-4',
+   *   model: 'gpt-4o',
    *   maxTokens: 200,
    *   temperature: 0.8
    * });
@@ -315,9 +326,9 @@ var TokenKit = class {
    * 
    * @example
    * ```typescript
-   * const models = await tokenKit.getModels();
+   * const response = await tokenKit.getModels();
    * console.log('Available models:', models);
-   * // ['gpt-3.5-turbo', 'gpt-4', 'gpt-4-turbo']
+   * // ['claude-3.5-haiku', 'claude-sonnet-4', 'nova-micro', 'nova-lite', 'gpt-4o', 'gpt-4o-mini']
    * ```
    */
   async getModels() {
@@ -354,6 +365,7 @@ var TokenKit = class {
 var index_default = TokenKit;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ENVIRONMENT_URLS,
   TokenKit,
   TokenKitAPIError
 });

package/dist/index.mjs

@@ -12,6 +12,11 @@ var TokenKitAPIError = class extends Error {
     Error.captureStackTrace?.(this, this.constructor);
   }
 };
+var ENVIRONMENT_URLS = {
+  production: "https://api.token-kit.com/v1",
+  staging: "https://api-staging.token-kit.com/v1",
+  development: "https://api-dev.token-kit.com/v1"
+};
 
 // src/client.ts
 var TokenKitClient = class {
@@ -20,8 +25,9 @@ var TokenKitClient = class {
       throw new Error("API key is required");
     }
     this.apiKey = config.apiKey;
+    const baseURL = config.baseUrl ?? ENVIRONMENT_URLS[config.environment ?? "production"];
     this.client = axios.create({
-      baseURL: config.baseUrl || "https://api.token-kit.com/api/v1",
+      baseURL,
       timeout: config.timeout || 6e4,
       headers: {
         "Content-Type": "application/json",
@@ -165,7 +171,11 @@ var TokenKit = class {
    * 
    * @param config - Configuration options
    * @param config.apiKey - Your developer API key
-   * @param config.baseUrl - API base URL (optional, defaults to production)
+   * @param config.environment - Target environment: 'production' | 'staging' | 'development'
+   *   Resolves to the canonical API URL for that environment.
+   *   Defaults to 'production'. Ignored when `baseUrl` is also set.
+   * @param config.baseUrl - Explicit API base URL — overrides `environment`.
+   *   Use for self-hosted deployments or local tunnels.
    * @param config.timeout - Request timeout in ms (optional, defaults to 60000)
    */
   constructor(config) {
@@ -207,7 +217,7 @@ var TokenKit = class {
    *   { role: 'system', content: 'You are a helpful assistant.' },
    *   { role: 'user', content: 'Hello!' }
    * ], {
-   *   model: 'gpt-4',
+   *   model: 'gpt-4o',
    *   maxTokens: 200,
    *   temperature: 0.8
    * });
@@ -277,9 +287,9 @@ var TokenKit = class {
    * 
    * @example
    * ```typescript
-   * const models = await tokenKit.getModels();
+   * const response = await tokenKit.getModels();
    * console.log('Available models:', models);
-   * // ['gpt-3.5-turbo', 'gpt-4', 'gpt-4-turbo']
+   * // ['claude-3.5-haiku', 'claude-sonnet-4', 'nova-micro', 'nova-lite', 'gpt-4o', 'gpt-4o-mini']
    * ```
    */
   async getModels() {
@@ -315,6 +325,7 @@ var TokenKit = class {
 };
 var index_default = TokenKit;
 export {
+  ENVIRONMENT_URLS,
   TokenKit,
   TokenKitAPIError,
   index_default as default

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@codetunezstudios/token-kit",
-    "version": "0.1.0-beta.1",
+    "version": "0.1.0-beta.3",
     "description": "Official TypeScript SDK for token-kit - AI token infrastructure for developers",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -33,7 +33,8 @@
         "openai",
         "gpt",
         "claude",
-        "gemini",
+        "bedrock",
+        "amazon-nova",
         "tokens",
         "sdk",
         "typescript",