feat: add modular content creation primitive endpoints

app/api/content/analyze/route.ts

@@ -0,0 +1,23 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { createAnalyzeHandler } from "@/lib/content/analyze/createAnalyzeHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * POST /api/content/analyze
+ *
+ * Analyze a video with AI — describe scenes, check quality, evaluate content.
+ */
+export async function POST(request: NextRequest): Promise<NextResponse> {
+  return createAnalyzeHandler(request);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

app/api/content/caption/route.ts

@@ -0,0 +1,23 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { createTextHandler } from "@/lib/content/caption/createTextHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * POST /api/content/caption
+ *
+ * Generate on-screen caption text for a social video.
+ */
+export async function POST(request: NextRequest): Promise<NextResponse> {
+  return createTextHandler(request);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

app/api/content/image/route.ts

@@ -0,0 +1,23 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { createImageHandler } from "@/lib/content/image/createImageHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * POST /api/content/image
+ *
+ * Generate an image from a prompt and optional reference image.
+ */
+export async function POST(request: NextRequest): Promise<NextResponse> {
+  return createImageHandler(request);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

app/api/content/route.ts

@@ -0,0 +1,23 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { editHandler } from "@/lib/content/edit/editHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * PATCH /api/content
+ *
+ * Edit media with operations or a template preset.
+ */
+export async function PATCH(request: NextRequest): Promise<NextResponse> {
+  return editHandler(request);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

app/api/content/templates/[id]/route.ts

@@ -0,0 +1,26 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { getContentTemplateDetailHandler } from "@/lib/content/getContentTemplateDetailHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * GET /api/content/templates/[id]
+ *
+ * Returns the full template configuration for a given template id.
+ */
+export async function GET(
+  request: NextRequest,
+  context: { params: Promise<{ id: string }> },
+): Promise<NextResponse> {
+  return getContentTemplateDetailHandler(request, context);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

app/api/content/transcribe/route.ts

@@ -0,0 +1,23 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { createAudioHandler } from "@/lib/content/transcribe/createAudioHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * POST /api/content/transcribe
+ *
+ * Transcribe audio into text with word-level timestamps.
+ */
+export async function POST(request: NextRequest): Promise<NextResponse> {
+  return createAudioHandler(request);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

app/api/content/upscale/route.ts

@@ -0,0 +1,23 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { createUpscaleHandler } from "@/lib/content/upscale/createUpscaleHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * POST /api/content/upscale
+ *
+ * Upscale an image or video to higher resolution.
+ */
+export async function POST(request: NextRequest): Promise<NextResponse> {
+  return createUpscaleHandler(request);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

app/api/content/video/route.ts

@@ -0,0 +1,23 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getCorsHeaders } from "@/lib/networking/getCorsHeaders";
+import { createVideoHandler } from "@/lib/content/video/createVideoHandler";
+
+/**
+ * OPTIONS handler for CORS preflight requests.
+ */
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: getCorsHeaders() });
+}
+
+/**
+ * POST /api/content/video
+ *
+ * Generate a video from a prompt, image, or existing video.
+ */
+export async function POST(request: NextRequest): Promise<NextResponse> {
+  return createVideoHandler(request);
+}
+
+export const dynamic = "force-dynamic";
+export const fetchCache = "force-no-store";
+export const revalidate = 0;

lib/content/__tests__/getContentTemplateDetailHandler.test.ts

@@ -0,0 +1,94 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { NextRequest, NextResponse } from "next/server";
+import { getContentTemplateDetailHandler } from "@/lib/content/getContentTemplateDetailHandler";
+import { validateAuthContext } from "@/lib/auth/validateAuthContext";
+import { loadTemplate } from "@/lib/content/templates";
+
+vi.mock("@/lib/networking/getCorsHeaders", () => ({
+  getCorsHeaders: vi.fn(() => ({ "Access-Control-Allow-Origin": "*" })),
+}));
+
+vi.mock("@/lib/auth/validateAuthContext", () => ({
+  validateAuthContext: vi.fn(),
+}));
+
+vi.mock("@/lib/content/templates", () => ({
+  loadTemplate: vi.fn(),
+}));
+
+describe("getContentTemplateDetailHandler", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("returns 401 when not authenticated", async () => {
+    vi.mocked(validateAuthContext).mockResolvedValue(
+      NextResponse.json({ status: "error", error: "Unauthorized" }, { status: 401 }),
+    );
+    const request = new NextRequest("http://localhost/api/content/templates/bedroom", {
+      method: "GET",
+    });
+
+    const result = await getContentTemplateDetailHandler(request, {
+      params: Promise.resolve({ id: "bedroom" }),
+    });
+
+    expect(result.status).toBe(401);
+  });
+
+  it("returns 404 for unknown template", async () => {
+    vi.mocked(validateAuthContext).mockResolvedValue({
+      accountId: "acc_123",
+      orgId: null,
+      authToken: "test-key",
+    });
+    vi.mocked(loadTemplate).mockReturnValue(null);
+
+    const request = new NextRequest("http://localhost/api/content/templates/nonexistent", {
+      method: "GET",
+    });
+
+    const result = await getContentTemplateDetailHandler(request, {
+      params: Promise.resolve({ id: "nonexistent" }),
+    });
+    const body = await result.json();
+
+    expect(result.status).toBe(404);
+    expect(body.error).toBe("Template not found");
+  });
+
+  it("returns full template for valid id", async () => {
+    vi.mocked(validateAuthContext).mockResolvedValue({
+      accountId: "acc_123",
+      orgId: null,
+      authToken: "test-key",
+    });
+    const mockTemplate = {
+      id: "artist-caption-bedroom",
+      description: "Moody purple bedroom setting",
+      image: { prompt: "test", reference_images: [], style_rules: {} },
+      video: { moods: ["calm"], movements: ["slow pan"] },
+      caption: { guide: { tone: "dreamy", rules: [], formats: [] }, examples: [] },
+      edit: { operations: [] },
+    };
+    vi.mocked(loadTemplate).mockReturnValue(mockTemplate);
+
+    const request = new NextRequest(
+      "http://localhost/api/content/templates/artist-caption-bedroom",
+      { method: "GET" },
+    );
+
+    const result = await getContentTemplateDetailHandler(request, {
+      params: Promise.resolve({ id: "artist-caption-bedroom" }),
+    });
+    const body = await result.json();
+
+    expect(result.status).toBe(200);
+    expect(body.id).toBe("artist-caption-bedroom");
+    expect(body.description).toBe("Moody purple bedroom setting");
+    expect(body.image).toBeDefined();
+    expect(body.video).toBeDefined();
+    expect(body.caption).toBeDefined();
+    expect(body.edit).toBeDefined();
+  });
+});