Skip to content
Source
Sign inSign up
TanStack/ai
Open History to see the last commit

complete-feature-demo.ts

232 lines7.1 KB

1/**
2 * Complete Feature Demonstration
3 *
4 * Shows both type-safe models and automatic fallback in action
5 */
6
7import { AI } from "../packages/ai/src";
8import { OpenAIAdapter } from "../packages/ai-openai/src";
9import { AnthropicAdapter } from "../packages/ai-anthropic/src";
11// Setup AI with multiple adapters and fallback order
12const ai = new AI({
13 adapters: {
14 openai: new OpenAIAdapter({
15 apiKey: process.env.OPENAI_API_KEY || "",
16 }),
17 anthropic: new AnthropicAdapter({
18 apiKey: process.env.ANTHROPIC_API_KEY || "",
19 }),
20 },
21 fallbackOrder: ["openai", "anthropic"], // Try OpenAI first, then Anthropic
22});
24// ============================================
25// FEATURE 1: TYPE-SAFE MODELS
26// ============================================
28async function demonstrateTypeSafety() {
29 console.log("\nπŸ”’ TYPE SAFETY DEMONSTRATION\n");
31 // βœ… VALID: OpenAI with GPT model
32 console.log("βœ… Valid: OpenAI with gpt-4");
33 await ai.chat({
34 adapter: "openai",
35 model: "gpt-4", // TypeScript validates this
36 messages: [{ role: "user", content: "Hello from OpenAI!" }],
37 });
39 // βœ… VALID: Anthropic with Claude model
40 console.log("βœ… Valid: Anthropic with Claude");
41 await ai.chat({
42 adapter: "anthropic",
43 model: "claude-3-5-sonnet-20241022", // TypeScript validates this
44 messages: [{ role: "user", content: "Hello from Anthropic!" }],
45 });
47 // ❌ INVALID: Would show TypeScript error (commented out)
48 // console.log("❌ Invalid: Anthropic with GPT model");
49 // await ai.chat({
50 // adapter: "anthropic",
51 // model: "gpt-4", // ❌ TypeScript Error: gpt-4 not valid for Anthropic
52 // messages: [{ role: "user", content: "This won't compile!" }],
53 // });
55 console.log("\nβœ… Type safety working!\n");
56}
58// ============================================
59// FEATURE 2: AUTOMATIC FALLBACK
60// ============================================
62async function demonstrateFallback() {
63 console.log("\nπŸ”„ AUTOMATIC FALLBACK DEMONSTRATION\n");
65 try {
66 console.log("Attempting chat with fallback...");
67 console.log("Will try: openai -> anthropic\n");
69 const result = await ai.chat({
70 adapters: ["openai", "anthropic"], // Try both in order
71 model: "gpt-4", // Works with OpenAI
72 messages: [
73 {
74 role: "user",
75 content: "What is the capital of France?",
76 },
77 ],
78 });
80 console.log("βœ… Success!");
81 console.log("Response:", result.content);
82 } catch (error: any) {
83 console.error("❌ All adapters failed:", error.message);
84 }
85}
87// ============================================
88// FEATURE 3: COMBINING BOTH
89// ============================================
91async function demonstrateCombined() {
92 console.log("\n🎯 COMBINED: TYPE SAFETY + FALLBACK\n");
94 // Scenario: Use type-safe single adapter for most requests
95 console.log("1️⃣ Normal operation (type-safe, no fallback):");
96 try {
97 const result = await ai.chat({
98 adapter: "openai", // βœ… Type-safe
99 model: "gpt-4", // βœ… Validated against OpenAI
100 messages: [{ role: "user", content: "What is 2+2?" }],
101 });
102 console.log("βœ… OpenAI:", result.content);
103 } catch (error: any) {
104 console.log("❌ OpenAI failed:", error.message);
105 }
107 // Scenario: Use fallback for critical operations
108 console.log("\n2️⃣ Critical operation (with fallback):");
109 try {
110 const result = await ai.chat({
111 adapters: ["openai", "anthropic"], // Fallback enabled
112 model: "gpt-4", // Less strict but has fallback
113 messages: [{ role: "user", content: "Important question: What is 2+2?" }],
114 });
115 console.log("βœ… Result:", result.content);
116 } catch (error: any) {
117 console.log("❌ All failed:", error.message);
118 }
119}
121// ============================================
122// FEATURE 4: PER-REQUEST CONFIGURATION
123// ============================================
125async function demonstratePerRequest() {
126 console.log("\nβš™οΈ PER-REQUEST CONFIGURATION\n");
128 // Regular chat: Use default fallback order
129 console.log("1️⃣ Using global fallback order (openai -> anthropic):");
130 await ai.chat({
131 adapters: [], // Empty = use global fallbackOrder
132 model: "gpt-4",
133 messages: [{ role: "user", content: "Regular question" }],
134 });
136 // Critical chat: Custom order prioritizing Anthropic
137 console.log("\n2️⃣ Override with custom order (anthropic -> openai):");
138 await ai.chat({
139 adapters: ["anthropic", "openai"], // Custom order for this request
140 model: "claude-3-5-sonnet-20241022",
141 messages: [{ role: "user", content: "Critical question" }],
142 });
144 console.log("\nβœ… Per-request configuration working!\n");
145}
147// ============================================
148// FEATURE 5: ERROR HANDLING WITH DETAILS
149// ============================================
151async function demonstrateErrorHandling() {
152 console.log("\n🚨 ERROR HANDLING DEMONSTRATION\n");
154 try {
155 console.log("Attempting operation with invalid configuration...\n");
157 await ai.chat({
158 adapters: ["openai", "anthropic"],
159 model: "invalid-model" as any, // Force error
160 messages: [{ role: "user", content: "Test" }],
161 });
162 } catch (error: any) {
163 console.log("βœ… Caught error with details:\n");
164 console.log(error.message);
165 console.log("\nπŸ“ This shows which adapters failed and why");
166 }
167}
169// ============================================
170// FEATURE 6: STREAMING WITH FALLBACK
171// ============================================
173async function demonstrateStreamingFallback() {
174 console.log("\n🌊 STREAMING WITH FALLBACK\n");
176 try {
177 console.log("Streaming with fallback enabled...\n");
179 for await (const chunk of ai.streamChat({
180 adapters: ["openai", "anthropic"],
181 model: "gpt-4",
182 messages: [{ role: "user", content: "Count from 1 to 5" }],
183 })) {
184 if (chunk.type === "content") {
185 process.stdout.write(chunk.delta);
186 }
187 }
189 console.log("\n\nβœ… Streaming with fallback working!\n");
190 } catch (error: any) {
191 console.error("❌ Streaming failed:", error.message);
192 }
193}
195// ============================================
196// MAIN DEMO
197// ============================================
199async function runDemo() {
200 console.log("=".repeat(60));
201 console.log("TYPE-SAFE MULTI-ADAPTER WITH AUTOMATIC FALLBACK");
202 console.log("=".repeat(60));
204 try {
205 await demonstrateTypeSafety();
206 await demonstrateFallback();
207 await demonstrateCombined();
208 await demonstratePerRequest();
209 await demonstrateErrorHandling();
210 await demonstrateStreamingFallback();
212 console.log("=".repeat(60));
213 console.log("βœ… ALL FEATURES WORKING CORRECTLY!");
214 console.log("=".repeat(60));
215 } catch (error: any) {
216 console.error("\n❌ Demo error:", error.message);
217 }
218}
220// Uncomment to run:
221// runDemo();
223export {
224 ai,
225 demonstrateTypeSafety,
226 demonstrateFallback,
227 demonstrateCombined,
228 demonstratePerRequest,
229 demonstrateErrorHandling,
230 demonstrateStreamingFallback,
231 runDemo,
232};