Verified example · TypeScript
Server handler
examples/server-handler.ts
@cavi-ai/api-clientv0.21.007f0ee45
import { isAuthError, type CapabilityClient } from "@cavi-ai/api-client";
export function createRunHandler(
client: CapabilityClient,
model: string,
reportError: (error: unknown) => void,
) {
return async function handle(request: Request): Promise<Response> {
if (request.method !== "POST") {
return Response.json({ error: "Use POST." }, { status: 405, headers: { Allow: "POST" } });
}
let body: unknown;
try {
body = await request.json();
} catch {
return Response.json({ error: "Expected JSON." }, { status: 400 });
}
if (!body || typeof body !== "object" || !("input" in body) ||
typeof body.input !== "string" || body.input.trim() === "") {
return Response.json({ error: "Provide a non-empty input string." }, { status: 400 });
}
try {
const result = await client.startRun({ model, input: body.input });
if (!result.ok) {
reportError(result.gap);
return Response.json({ error: "Run unavailable.", reason: result.gap.reason }, { status: 503 });
}
const run = result.data;
const active = ["started", "running", "stopping"].includes(run.status);
const status = active ? 202 : run.status === "completed" ? 200 : 502;
return Response.json({
runId: run.run_id,
status: run.status,
text: run.output ?? run.response,
tokens: run.tokens,
}, { status });
} catch (error) {
reportError(error);
if (isAuthError(error)) {
// These are server-owned provider credentials, not the caller's login.
return Response.json({ error: "Runtime authentication unavailable." }, { status: 503 });
}
return Response.json({ error: "Run request failed." }, { status: 502 });
}
};
}
Package imports
Referenced by
Artifact provenance
- Package
- @cavi-ai/api-client@0.21.0
- Release
- v0.21.0
- Commit
07f0ee45424c267278f7b0c89a7dcea4e2492cc1- Source
examples/server-handler.ts- Tarball SHA-256
0924b5d3a7a40869bd44fedc47a9b8eb9844c2af1fd5c7ca77469d8b7c0b8558- Content SHA-256
24eff463c41582eaf5e70c58f42e5ae13bd12d02fa14ae2a886afa3abf5cdf48