Files
XBid/src/app/api/v1/quotes/route.ts
T
twotalesanimation 8a93a18bb9 Add REST API for quotes, shots, assets and tasks
Adds a key-authenticated REST API at /api/v1 so another system can create
and manage quotes without going through the UI.

Endpoints cover quotes (list, create, read, update, delete, recalculate),
shots, assets and line items, plus read-only clients and rate cards.
POST /api/v1/quotes builds a whole priced quote -- client, shots, assets
and tasks -- in a single transaction. Routes are also mounted under
/api/v1/jobs, since a quote and a job are the same record here.

Keys are stored as SHA-256 with a display prefix, so the plaintext is
shown once at creation and is not recoverable. They carry read/write
scopes, can be revoked (effective on the next request), and record when
they were last used. Minting and revoking live in Settings and are
restricted to signed-in admins.

/api/v1 is exempt from the session proxy because it authenticates with a
bearer key rather than a cookie -- without this, every API call was
redirected to /login as a 307. It is not unprotected: each route handler
requires a live, unrevoked key with the right scope.

Shot numbering and shot-code construction move into lib/shot-codes.ts so
the UI and the API cannot drift. This also fixes numbering restarting at
0010 when a scene was entered in a different case to the stored one: the
lookup upper-cased the scene but the stored value was left as typed.

Unspecified currency and markup/tax/discount on an API-created quote fall
back to the studio's configured quote defaults.

Decimal fields are serialised as strings to preserve the exact precision
the app's decimal arithmetic maintains.

Note: this needs `prisma migrate deploy` for the new api_keys table.
Settings will error for admins until that runs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-11-11 09:10:45 +02:00

59 lines
1.9 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import type { NextRequest } from "next/server";
import { revalidatePath } from "next/cache";
import { prisma } from "@/lib/prisma";
import { apiCreated, apiOk, readJsonBody } from "@/lib/api-response";
import { apiRoute, parseQuery } from "@/lib/api-route";
import { apiListQuerySchema, apiQuoteCreateSchema } from "@/lib/api-validations";
import { createQuoteFromApi } from "@/lib/api-quotes";
/**
* GET /api/v1/quotes — list quotes, newest first.
*
* Query: `limit` (1–100, default 25), `offset`, `status`, `clientId`,
* `search` (matches project title or code).
*/
export const GET = apiRoute<unknown>("read", async (req: NextRequest) => {
const { limit, offset, status, clientId, search } = parseQuery(apiListQuerySchema, req);
const where = {
...(status ? { status } : {}),
...(clientId ? { clientId } : {}),
...(search
? {
OR: [
{ projectTitle: { contains: search, mode: "insensitive" as const } },
{ projectCode: { contains: search, mode: "insensitive" as const } },
],
}
: {}),
};
const [quotes, total] = await Promise.all([
prisma.job.findMany({
where,
orderBy: { createdAt: "desc" },
take: limit,
skip: offset,
include: {
client: { select: { id: true, companyName: true, contactPerson: true } },
_count: { select: { shots: true, assets: true, supervisions: true, previses: true } },
},
}),
prisma.job.count({ where }),
]);
return apiOk(quotes, { total, limit, offset, returned: quotes.length });
});
/**
* POST /api/v1/quotes — create a quote, optionally with its whole
* shot/asset/task tree in the same request. Runs in one transaction.
*/
export const POST = apiRoute<unknown>("write", async (req: NextRequest) => {
const input = apiQuoteCreateSchema.parse(await readJsonBody(req));
const quote = await createQuoteFromApi(input);
revalidatePath("/jobs");
return apiCreated(quote);
});