@revenium/perplexity 1.0.0

package/examples/openai-client-example.ts

@@ -0,0 +1,76 @@
+import { config } from "dotenv";
+import { OpenAI } from "openai";
+
+// Import middleware to activate automatic tracking
+import "../src/perplexity-ai";
+
+config();
+
+async function openaiClientExample() {
+  console.log("\n🤖 Perplexity AI - OpenAI Client Example");
+  console.log("=".repeat(50));
+
+  try {
+    // Create OpenAI client configured for Perplexity (like in basic example)
+    const client = new OpenAI({
+      apiKey: process.env.PERPLEXITY_API_KEY,
+      baseURL: "https://api.perplexity.ai",
+    });
+
+    console.log("✅ OpenAI client configured for Perplexity AI");
+    console.log("📊 Middleware automatically tracking all requests");
+
+    // Test different types of requests
+    console.log("\n1️⃣ Basic chat completion:");
+    const basicResponse = await client.chat.completions.create({
+      model: "sonar-pro",
+      messages: [
+        {
+          role: "user",
+          content: "What is the meaning of life, the universe and everything?",
+        },
+      ],
+    });
+    console.log("✅ Response:", basicResponse.choices[0]?.message?.content?.substring(0, 100) + "...");
+
+    console.log("\n2️⃣ Streaming chat completion:");
+    const stream = await client.chat.completions.create({
+      model: "sonar-pro",
+      messages: [
+        {
+          role: "user",
+          content: "Write a short poem about AI",
+        },
+      ],
+      stream: true,
+    });
+
+    console.log("📝 Streaming response:");
+    for await (const chunk of stream) {
+      const content = chunk.choices[0]?.delta?.content;
+      if (content) {
+        process.stdout.write(content);
+      }
+    }
+
+    console.log("\n\n3️⃣ Different prompt:");
+    const differentResponse = await client.chat.completions.create({
+      model: "sonar-pro",
+      messages: [
+        {
+          role: "user",
+          content: "Explain machine learning in one sentence",
+        },
+      ],
+    });
+    console.log("✅ Response:", differentResponse.choices[0]?.message?.content);
+
+    console.log("\n🎉 All examples completed successfully!");
+    console.log("📊 All usage automatically tracked by middleware");
+
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+}
+
+openaiClientExample().catch(console.error);

package/examples/perplexity_basic_example.ts

@@ -0,0 +1,24 @@
+import { config } from "dotenv";
+import { OpenAI } from "openai";
+
+config();
+
+const client = new OpenAI({
+  apiKey: process.env.PERPLEXITY_API_KEY,
+  baseURL: "https://api.perplexity.ai",
+});
+
+const getResponse = async () => {
+  const response = await client.chat.completions.create({
+    model: "sonar-pro",
+    messages: [
+      {
+        role: "user",
+        content: "What is the meaning of life, the universe and everything?",
+      },
+    ],
+  });
+  console.log("response", response);
+};
+
+getResponse();

package/examples/perplexity_middleware_example.ts

@@ -0,0 +1,222 @@
+import { config } from "dotenv";
+import { OpenAI } from "openai";
+
+// Importar el middleware para activar el tracking automático
+import "../src/index";
+
+config();
+
+// Configurar el cliente de OpenAI para usar Perplexity
+const client = new OpenAI({
+  apiKey: process.env.PERPLEXITY_API_KEY,
+  baseURL: "https://api.perplexity.ai",
+});
+
+/**
+ * Ejemplo básico usando el middleware
+ */
+const basicExample = async () => {
+  console.log("\n🤖 Perplexity AI - Middleware Example");
+  console.log("=".repeat(50));
+
+  const perplexityApiKey = process.env.PERPLEXITY_API_KEY;
+  const reveniumKey = process.env.REVENIUM_METERING_API_KEY;
+
+  if (!perplexityApiKey) {
+    console.log("❌ PERPLEXITY_API_KEY not found");
+    console.log("   Set: export PERPLEXITY_API_KEY=your-perplexity-api-key");
+    return false;
+  }
+
+  if (!reveniumKey) {
+    console.log(
+      "⚠️  REVENIUM_METERING_API_KEY not found - metering will be disabled"
+    );
+    console.log("   Set: export REVENIUM_METERING_API_KEY=your-revenium-key");
+  }
+
+  console.log(`✅ Perplexity API Key: ${perplexityApiKey.substring(0, 10)}...`);
+  if (reveniumKey) {
+    console.log(`✅ Revenium Key: ${reveniumKey.substring(0, 10)}...`);
+  }
+
+  try {
+    const response = await client.chat.completions.create({
+      model: "sonar-pro",
+      messages: [
+        {
+          role: "user",
+          content: "What is the meaning of life, the universe and everything?",
+        },
+      ],
+    });
+
+    const content = response.choices[0]?.message?.content;
+    if (content) {
+      console.log(`✅ Response: ${content.substring(0, 100)}...`);
+    } else {
+      console.log("✅ Response received (no content)");
+    }
+    console.log("✅ Response received successfully");
+    console.log("📊 Token usage automatically tracked by middleware");
+    console.log("🎉 Middleware integration successful!");
+    return true;
+  } catch (error) {
+    console.log(`❌ Perplexity test failed: ${error}`);
+    console.error(error);
+    return false;
+  }
+};
+
+/**
+ * Ejemplo con metadatos de uso
+ */
+const enhancedExample = async () => {
+  console.log("\n📊 Perplexity AI - Enhanced Tracking Example");
+  console.log("=".repeat(50));
+
+  const perplexityApiKey = process.env.PERPLEXITY_API_KEY;
+  if (!perplexityApiKey) {
+    console.log("❌ PERPLEXITY_API_KEY not found");
+    return false;
+  }
+
+  try {
+    const response = await client.chat.completions.create({
+      model: "sonar-pro",
+      messages: [
+        {
+          role: "user",
+          content: "Analyze this quarterly report for key insights",
+        },
+      ],
+      // Los metadatos se pueden incluir en el body de la request
+      // El middleware los detectará automáticamente
+    });
+
+    const content = response.choices[0]?.message?.content;
+    if (content) {
+      console.log(`✅ Enhanced response: ${content.substring(0, 100)}...`);
+    } else {
+      console.log("✅ Enhanced response received (no content)");
+    }
+    console.log("🎯 Enhanced tracking with middleware successful!");
+    return true;
+  } catch (error) {
+    console.log(`❌ Perplexity enhanced test failed: ${error}`);
+    console.error(error);
+    return false;
+  }
+};
+
+/**
+ * Ejemplo con streaming
+ */
+const streamingExample = async () => {
+  console.log("\n🌊 Perplexity AI - Streaming Example");
+  console.log("=".repeat(50));
+
+  const perplexityApiKey = process.env.PERPLEXITY_API_KEY;
+  if (!perplexityApiKey) {
+    console.log("❌ PERPLEXITY_API_KEY not found");
+    return false;
+  }
+
+  try {
+    const stream = await client.chat.completions.create({
+      model: "sonar-pro",
+      messages: [
+        {
+          role: "user",
+          content: "Write a creative story about AI",
+        },
+      ],
+      stream: true,
+    });
+
+    let streamedContent = "";
+    for await (const chunk of stream) {
+      const content = chunk.choices[0]?.delta?.content;
+      if (content) {
+        streamedContent += content;
+        process.stdout.write(content);
+      }
+    }
+
+    console.log("\n✅ Streaming completed successfully");
+    console.log("📊 Streaming usage automatically tracked by middleware");
+    return true;
+  } catch (error) {
+    console.log(`❌ Perplexity streaming test failed: ${error}`);
+    console.error(error);
+    return false;
+  }
+};
+
+/**
+ * Ejemplo con diferentes modelos
+ */
+const differentModelExample = async () => {
+  console.log("\n🔧 Perplexity AI - Different Model Example");
+  console.log("=".repeat(50));
+
+  const perplexityApiKey = process.env.PERPLEXITY_API_KEY;
+  if (!perplexityApiKey) {
+    console.log("❌ PERPLEXITY_API_KEY not found");
+    return false;
+  }
+
+  try {
+    const response = await client.chat.completions.create({
+      model: "sonar-pro",
+      messages: [
+        {
+          role: "user",
+          content: "Explain quantum computing in simple terms",
+        },
+      ],
+    });
+
+    const content = response.choices[0]?.message?.content;
+    if (content) {
+      console.log(`✅ Llama response: ${content.substring(0, 100)}...`);
+    } else {
+      console.log("✅ Llama response received (no content)");
+    }
+    console.log("✅ Different model test successful!");
+    return true;
+  } catch (error) {
+    console.log(`❌ Perplexity different model test failed: ${error}`);
+    console.error(error);
+    return false;
+  }
+};
+
+/**
+ * Función principal que ejecuta todos los ejemplos
+ */
+const main = async (): Promise<void> => {
+  console.log("🚀 Starting Revenium Perplexity AI Middleware Examples");
+  console.log("=".repeat(60));
+
+  let successCount = 0;
+  const totalTests: number = 4;
+
+  // Ejecutar ejemplos de Perplexity AI
+  if (await basicExample()) successCount++;
+  if (await enhancedExample()) successCount++;
+  if (await streamingExample()) successCount++;
+  if (await differentModelExample()) successCount++;
+
+  console.log("\n" + "=".repeat(60));
+  console.log(`📊 Test Results: ${successCount}/${totalTests} tests passed`);
+
+  if (successCount === totalTests) {
+    console.log("🎉 All tests passed! Middleware is working correctly.");
+  } else {
+    console.log("⚠️  Some tests failed. Check the logs above for details.");
+  }
+};
+
+// Ejecutar el ejemplo
+main().catch(console.error);

package/examples/run-all-examples.ts

@@ -0,0 +1,118 @@
+import { config } from "dotenv";
+import { createPerplexityClient } from "../src/perplexity-ai";
+
+config();
+
+async function runAllExamples() {
+  console.log("🚀 Running All Perplexity AI Middleware Examples");
+  console.log("=".repeat(60));
+
+  const examples = [
+    {
+      name: "Basic Client Example",
+      run: async () => {
+        const client = createPerplexityClient();
+        const response = await client.createChatCompletion({
+          model: "sonar-pro",
+          messages: [
+            {
+              role: "user",
+              content: "Say hello in one sentence",
+            },
+          ],
+        });
+        return response.choices[0]?.message?.content || "";
+      },
+    },
+    {
+      name: "Streaming Example",
+      run: async () => {
+        const client = createPerplexityClient();
+        const stream = await client.createStreamingChatCompletion({
+          model: "sonar-pro",
+          messages: [
+            {
+              role: "user",
+              content: "Write a very short story",
+            },
+          ],
+        });
+
+        let content = "";
+        for await (const chunk of stream) {
+          const chunkContent = chunk.choices[0]?.delta?.content;
+          if (chunkContent) {
+            content += chunkContent;
+          }
+        }
+        return content;
+      },
+    },
+    {
+      name: "Multiple Models Example",
+      run: async () => {
+        const client = createPerplexityClient();
+        const response = await client.createChatCompletion({
+          model: "sonar-pro",
+          messages: [
+            {
+              role: "user",
+              content: "What is AI?",
+            },
+          ],
+        });
+        return response.choices[0]?.message?.content || "";
+      },
+    },
+    {
+      name: "Metadata Example",
+      run: async () => {
+        const client = createPerplexityClient();
+        const response = await client.createChatCompletion({
+          model: "sonar-pro",
+          messages: [
+            {
+              role: "user",
+              content: "What is the weather like?",
+            },
+          ],
+          usageMetadata: {
+            traceId: "test-123",
+            taskType: "weather-query",
+            organizationId: "test-org",
+          },
+        });
+        return response.choices[0]?.message?.content || "";
+      },
+    },
+  ];
+
+  let successCount = 0;
+  const totalExamples = examples.length;
+
+  for (const example of examples) {
+    console.log(`\n🤖 Running: ${example.name}`);
+    console.log("-".repeat(40));
+
+    try {
+      const result = await example.run();
+      console.log("✅ Success!");
+      console.log("📝 Response:", result.substring(0, 100) + "...");
+      successCount++;
+    } catch (error) {
+      console.log("❌ Failed:", error);
+    }
+  }
+
+  console.log("\n" + "=".repeat(60));
+  console.log(`📊 Results: ${successCount}/${totalExamples} examples passed`);
+
+  if (successCount === totalExamples) {
+    console.log("🎉 All examples completed successfully!");
+    console.log("✅ Middleware is working correctly");
+  } else {
+    console.log("⚠️  Some examples failed. Check the logs above.");
+  }
+}
+
+runAllExamples().catch(console.error);