Open source CapCut alternative.
TypeScript
import { matchRouteTable } from "./match";
import { errorReply } from "../util";
import { aiApi } from "./ai";
import { localSceneLease } from "../ai/sceneLease";
import { convertApi } from "./convert";
import { proxyApi } from "./proxy";
import { engineApi } from "./engine";
import { exportApi } from "./export";
import { libraryApi } from "./library";
import { micApi } from "./mic";
import { phoneLinkApi } from "./phoneLink";
import { projectsApi } from "./projects";
import { sttApi } from "./stt";
type TableHandler = (req: Request, params: Record<string, string>) => Response | Promise<Response>;
interface CutRoute {
method: "GET" | "POST" | "PUT" | "DELETE";
path: string; // ":name" segments bind params
handler: TableHandler;
}
/**
* The whole Cut API surface in one table, namespaced under /api/cut/* to keep it
* clear of Donkey's own APIs. Both mounts dispatch through it — the Next
* catch-all route and the packaged engine — so the two surfaces cannot drift.
*/
export const CUT_ROUTES: CutRoute[] = [
{ method: "GET", path: "/api/cut/engine/health", handler: () => engineApi.health() },
{ method: "GET", path: "/api/cut/projects", handler: () => projectsApi.list() },
{ method: "POST", path: "/api/cut/projects", handler: (req) => projectsApi.create(req) },
{ method: "GET", path: "/api/cut/projects/folders", handler: () => projectsApi.folders() },
{ method: "POST", path: "/api/cut/projects/folders", handler: (req) => projectsApi.createFolder(req) },
{ method: "PUT", path: "/api/cut/projects/folders/:id", handler: (req, p) => projectsApi.updateFolder(req, { id: p.id }) },
{ method: "DELETE", path: "/api/cut/projects/folders/:id", handler: (req, p) => projectsApi.deleteFolder(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/move", handler: (req, p) => projectsApi.move(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/projects/:id", handler: (req, p) => projectsApi.get(req, { id: p.id }) },
{ method: "PUT", path: "/api/cut/projects/:id", handler: (req, p) => projectsApi.put(req, { id: p.id }) },
{ method: "DELETE", path: "/api/cut/projects/:id", handler: (req, p) => projectsApi.remove(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/media", handler: (req, p) => projectsApi.uploadMedia(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/import-url", handler: (req, p) => projectsApi.importUrl(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/projects/:id/media/:file", handler: (req, p) => projectsApi.serveMedia(req, { id: p.id, file: p.file }) },
{ method: "DELETE", path: "/api/cut/projects/:id/media/:file", handler: (req, p) => projectsApi.removeMedia(req, { id: p.id, file: p.file }) },
{ method: "POST", path: "/api/cut/projects/:id/media/:file/reveal", handler: (req, p) => projectsApi.revealMedia(req, { id: p.id, file: p.file }) },
{ method: "GET", path: "/api/cut/projects/:id/exports", handler: (req, p) => projectsApi.listExports(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/projects/:id/exports/:file", handler: (req, p) => projectsApi.serveExport(req, { id: p.id, file: p.file }) },
{ method: "DELETE", path: "/api/cut/projects/:id/exports/:file", handler: (req, p) => projectsApi.removeExport(req, { id: p.id, file: p.file }) },
{ method: "POST", path: "/api/cut/projects/:id/exports/:file/reveal", handler: (req, p) => projectsApi.revealExport(req, { id: p.id, file: p.file }) },
{ method: "POST", path: "/api/cut/projects/:id/transcribe", handler: (req, p) => projectsApi.transcribeStart(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/projects/:id/transcribe", handler: (req, p) => projectsApi.transcribePoll(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/image", handler: (req, p) => projectsApi.importImage(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/freeze", handler: (req, p) => projectsApi.freeze(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/convert", handler: (req, p) => projectsApi.convert(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/proxy", handler: (req, p) => projectsApi.proxy(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/silence", handler: (req, p) => projectsApi.silence(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/audio", handler: (req, p) => projectsApi.audio(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/projects/:id/duplicate", handler: (req, p) => projectsApi.duplicate(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/projects/:id/preview", handler: (req, p) => projectsApi.servePreview(req, { id: p.id }) },
// The phone link: an iPhone shooting in the field hands its clips to this
// Mac over the app's peer listener, and the open editor claims them.
{ method: "GET", path: "/api/cut/phone", handler: () => phoneLinkApi.status() },
{ method: "POST", path: "/api/cut/phone/pair", handler: () => phoneLinkApi.pair() },
{ method: "DELETE", path: "/api/cut/phone/pair", handler: () => phoneLinkApi.cancelPairing() },
{ method: "POST", path: "/api/cut/phone/pair/claim", handler: (req) => phoneLinkApi.claim(req) },
{ method: "POST", path: "/api/cut/phone/verify", handler: (req) => phoneLinkApi.verify(req) },
{ method: "GET", path: "/api/cut/phone/devices", handler: () => phoneLinkApi.devices() },
{ method: "DELETE", path: "/api/cut/phone/devices/:id", handler: (req, p) => phoneLinkApi.removeDevice(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/phone/clips", handler: (req) => phoneLinkApi.receive(req) },
{ method: "GET", path: "/api/cut/phone/clips", handler: () => phoneLinkApi.inbox() },
{ method: "POST", path: "/api/cut/phone/clips/:id/claim", handler: (req, p) => phoneLinkApi.claimClip(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/phone/clips/:id/release", handler: (req, p) => phoneLinkApi.releaseClip(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/phone/clips/:id/into-project", handler: (req, p) => phoneLinkApi.intoProject(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/phone/clips/:id/file", handler: (req, p) => phoneLinkApi.clipFile(req, { id: p.id }) },
{ method: "DELETE", path: "/api/cut/phone/clips/:id", handler: (req, p) => phoneLinkApi.removeClip(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/library", handler: () => libraryApi.list() },
{ method: "POST", path: "/api/cut/library", handler: (req) => libraryApi.upload(req) },
{ method: "POST", path: "/api/cut/library/use", handler: (req) => libraryApi.use(req) },
{ method: "POST", path: "/api/cut/library/save", handler: (req) => libraryApi.save(req) },
{ method: "POST", path: "/api/cut/library/import-url", handler: (req) => libraryApi.importUrl(req) },
{ method: "POST", path: "/api/cut/library/move", handler: (req) => libraryApi.move(req) },
{ method: "POST", path: "/api/cut/library/templates", handler: (req) => libraryApi.saveTemplate(req) },
{ method: "POST", path: "/api/cut/library/templates/import", handler: (req) => libraryApi.importTemplate(req) },
{ method: "POST", path: "/api/cut/library/templates/:id/use", handler: (req, p) => libraryApi.useTemplate(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/library/templates/:id/add", handler: (req, p) => libraryApi.addToTemplate(req, { id: p.id }) },
{ method: "PUT", path: "/api/cut/library/templates/:id", handler: (req, p) => libraryApi.renameTemplate(req, { id: p.id }) },
{ method: "DELETE", path: "/api/cut/library/templates/:id", handler: (req, p) => libraryApi.removeTemplate(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/library/folders", handler: (req) => libraryApi.createFolder(req) },
{ method: "PUT", path: "/api/cut/library/folders/:id", handler: (req, p) => libraryApi.updateFolder(req, { id: p.id }) },
{ method: "DELETE", path: "/api/cut/library/folders/:id", handler: (req, p) => libraryApi.deleteFolder(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/library/media/:file", handler: (req, p) => libraryApi.serveMedia(req, { file: p.file }) },
{ method: "POST", path: "/api/cut/library/:id/proxy", handler: (req, p) => libraryApi.proxy(req, { id: p.id }) },
{ method: "PUT", path: "/api/cut/library/:id", handler: (req, p) => libraryApi.rename(req, { id: p.id }) },
{ method: "DELETE", path: "/api/cut/library/:id", handler: (req, p) => libraryApi.remove(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/export-jobs", handler: () => exportApi.activeAll() },
{ method: "POST", path: "/api/cut/export", handler: (req) => exportApi.create(req) },
{ method: "POST", path: "/api/cut/export/client", handler: (req) => exportApi.createClient(req) },
{ method: "POST", path: "/api/cut/export/client/:jobId/progress", handler: (req, p) => exportApi.clientProgress(req, { jobId: p.jobId }) },
{ method: "PUT", path: "/api/cut/export/client/:jobId/file", handler: (req, p) => exportApi.clientComplete(req, { jobId: p.jobId }) },
{ method: "PUT", path: "/api/cut/export/client/:jobId/stems", handler: (req, p) => exportApi.clientStems(req, { jobId: p.jobId }) },
{ method: "POST", path: "/api/cut/export/client/:jobId/release", handler: (req, p) => exportApi.clientRelease(req, { jobId: p.jobId }) },
{ method: "GET", path: "/api/cut/export/:jobId", handler: (req, p) => exportApi.status(req, { jobId: p.jobId }) },
{ method: "DELETE", path: "/api/cut/export/:jobId", handler: (req, p) => exportApi.cancel(req, { jobId: p.jobId }) },
{ method: "GET", path: "/api/cut/export/:jobId/file", handler: (req, p) => exportApi.file(req, { jobId: p.jobId }) },
{ method: "POST", path: "/api/cut/convert", handler: (req) => convertApi.create(req) },
{ method: "POST", path: "/api/cut/proxy", handler: (req) => proxyApi.create(req) },
{ method: "POST", path: "/api/cut/stt", handler: (req) => sttApi.create(req) },
{ method: "GET", path: "/api/cut/stt/:jobId", handler: (req, p) => sttApi.status(req, { jobId: p.jobId }) },
{ method: "POST", path: "/api/cut/mic/start", handler: (req) => micApi.start(req) },
{ method: "POST", path: "/api/cut/mic/:id/feed", handler: (req, p) => micApi.feed(req, { id: p.id }) },
{ method: "GET", path: "/api/cut/mic/:id", handler: (req, p) => micApi.poll(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/mic/:id/stop", handler: (req, p) => micApi.stop(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/mic/:id/cancel", handler: (req, p) => micApi.cancel(req, { id: p.id }) },
{ method: "POST", path: "/api/cut/ai/chat", handler: (req) => aiApi.chat(req) },
{ method: "POST", path: "/api/cut/projects/:id/scene-lease", handler: (req, p) => localSceneLease(p.id, req) },
{ method: "GET", path: "/api/cut/ai/chat/:id/stream", handler: (req, p) => aiApi.resumeChat(req, p.id) },
{ method: "POST", path: "/api/cut/ai/chat/:id/cancel", handler: (req, p) => aiApi.cancelChat(req, p.id) },
{ method: "POST", path: "/api/cut/ai/chat/:id/fold", handler: (req, p) => aiApi.foldChat(req, p.id) },
{ method: "POST", path: "/api/cut/ai/tool-claim", handler: (req) => aiApi.claimTool(req) },
{ method: "POST", path: "/api/cut/ai/captions", handler: (req) => aiApi.captions(req) },
{ method: "POST", path: "/api/cut/ai/visual-subtitles", handler: (req) => aiApi.visualSubtitles(req) },
{ method: "GET", path: "/api/cut/ai/models", handler: () => aiApi.models() },
{ method: "GET", path: "/api/cut/ai/proxy", handler: (req) => aiApi.proxyCatalog(req) },
{ method: "POST", path: "/api/cut/ai/proxy", handler: (req) => aiApi.proxyCall(req) },
{ method: "POST", path: "/api/cut/ai/tool-result", handler: (req) => aiApi.toolResult(req) },
{ method: "POST", path: "/api/cut/ai/gate", handler: (req) => aiApi.gate(req) },
];
export type RouteMatch =
| { handler: TableHandler; params: Record<string, string>; head: boolean }
| { methodNotAllowed: string[] };
/** Dispatch a matched route. The page still appends the signed-in account id
* (`u`) to engine URLs because engines released before 2026-08 refuse requests
* without it; this dispatch ignores it — local data belongs to the Mac user,
* whichever Donkey account is signed in. */
export async function runCutRoute(
req: Request,
match: { handler: TableHandler; params: Record<string, string> }
): Promise<Response> {
try {
return await match.handler(req, match.params);
} catch (error) {
return Response.json(errorReply(error, "The request failed."), { status: 500 });
}
}
/**
* Match a request against the table via the shared matcher (http/match.ts):
* static path segments win over dynamic ones, HEAD is served by the GET
* handler, and a path that exists for other methods returns 405.
*/
export function matchCutRoute(method: string, pathname: string): RouteMatch | null {
const match = matchRouteTable(CUT_ROUTES, method, pathname);
if (!match) return null;
if ("methodNotAllowed" in match) return match;
return {
handler: match.route.handler,
params: match.params,
head: match.head,
};
}