Skip to content

Open source CapCut alternative.

TypeScript
12.8 KB
Raw Blame
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,
  };
}