How to Test Ad Injection Locally in LlamaIndex.TS

Overview

You can develop ad injection for a LlamaIndex.TS app locally before going to production. Point the SDK at a local ad-server address and turn SSL off; everything else — the injection call, session context, fallback — behaves the same as production.

This lets you verify that your LlamaIndex.TS stream flows through injection and reaches the client correctly without needing production credentials wired up.

LlamaIndex.TS apps are usually built for RAG over private docs, knowledge-base search, and structured data QA, so test ad injection locally typically comes up while a user is mid-conversation, the moment where monetization has to be additive rather than disruptive.

How this works on LlamaIndex.TS

Use the TypeScript edition (LlamaIndex.TS) so you stay in the Node runtime the SDK requires. A streaming chat/query engine yields response chunks; map each chunk's text to { content } and pass into sdk.inject(). Confirm the chunk field name against your LlamaIndex.TS version.

Because Monetzly's inject() accepts any async token stream, the LlamaIndex.TS side of this task is just mapping your output to it, no rewrite of your LlamaIndex.TS model call.

Steps

1. Set the server address to your local host (e.g. localhost:8080) and disable SSL.
2. Run your LlamaIndex.TS app and send a test prompt through the injection path.
3. Confirm tokens stream to the client, then switch to your production host and SSL for release.

Integration snippet

import { MonetzlySDK } from "@monetzly/server-sdk";
// import a streaming chat engine from "llamaindex"

const sdk = new MonetzlySDK({
  apiKey: process.env.MONETZLY_API_KEY!,
  serverAddress: process.env.MONETZLY_SERVER_ADDRESS!,
});
await sdk.connect();

const stream = await chatEngine.chat({ message, stream: true });

async function* asChunks() {
  // TODO_VERIFY: confirm the text field (e.g. .response / .delta) for your version.
  for await (const chunk of stream) yield { content: chunk.response ?? chunk.delta ?? "" };
}

for await (const t of sdk.inject(asChunks(), { prompt: message })) send(t.content ?? "");
await sdk.disconnect();

Frequently asked questions

Related