Release 0.2.0: merge dev to main

.env.example

@@ -68,6 +68,14 @@ R2_BUCKET_NAME=videosphere-uploads
 # Optional: restrict allowed browser origin for R2 CORS behavior in your app logic
 # R2_ALLOWED_ORIGIN=https://your-domain.com
 
+# -----------------------------------------------------------------------------
+# YouTube import (download + trim from connected YouTube account)
+# -----------------------------------------------------------------------------
+# Scratch directory for in-progress downloads and trims (default: /tmp/yt-import)
+# YT_IMPORT_WORKDIR=/tmp/yt-import
+# Hard cap on source video length in seconds (default: 14400 / 4h)
+# YT_IMPORT_MAX_DURATION_SECONDS=14400
+
 # -----------------------------------------------------------------------------
 # OpenRouter (AI metadata generation)
 # -----------------------------------------------------------------------------

CONTRIBUTING.md

@@ -115,6 +115,8 @@ docker buildx build --platform linux/amd64,linux/arm64 -f Dockerfile .
 
 Omit `--load` and `--push` to discard images after a successful build. Cross-arch builds on amd64 require QEMU (`qemu-user-static` and binfmt).
 
+To **build and run** the image locally (amd64 smoke test, OAuth, production server), see [docs/local-docker-testing.md](docs/local-docker-testing.md).
+
 ## Pull Request Process
 
 1. **Fill out the PR template** — it's provided automatically when you open a PR

Dockerfile

@@ -34,7 +34,10 @@ ENV NEXT_TELEMETRY_DISABLED=1
 RUN pnpm build
 
 FROM node:${NODE_VERSION}-alpine AS runner
-RUN apk add --no-cache ffmpeg
+ARG YT_DLP_VERSION=2026.2.21
+RUN apk add --no-cache ffmpeg python3 py3-pip \
+    && pip3 install --break-system-packages "yt-dlp[default]==${YT_DLP_VERSION}" \
+    && yt-dlp --version && ffmpeg -version
 WORKDIR /app
 ENV NODE_ENV=production
 ENV NEXT_TELEMETRY_DISABLED=1

SETUP.md

@@ -92,18 +92,18 @@ an explicit Compose env file, so this command must include `--env-file .env.loca
 
 ### Option B: Docker run (also valid for local development)
 
-If you prefer running Mongo directly, this is supported:
+If you prefer running Mongo directly, this is supported. Use the **fully qualified** image name — Podman does not resolve short names like `mongo:8` unless your registry config defines search registries (Docker Desktop does this automatically).
 
 ```bash
-docker pull docker.io/mongo:8
+docker pull docker.io/library/mongo:8
 
 docker run -d \
   --name videosphere-mongo \
   -p 27017:27017 \
   -e MONGO_INITDB_ROOT_USERNAME=admin \
   -e MONGO_INITDB_ROOT_PASSWORD=localdevpassword \
   -v videosphere-mongo-data:/data/db \
-  mongo:8
+  docker.io/library/mongo:8
 ```
 
 When using this option, ensure your `.env.local` uses matching credentials, for example:
@@ -183,6 +183,14 @@ With Docker Compose, uncomment `network_mode: host` on the `app` service (see `d
 
 `pnpm dev` on the host (without Docker) can reach the LAN directly; host networking is only required when the app runs inside a container.
 
+## Testing a local Docker build
+
+To build the production image and run it on your machine (instead of `pnpm dev`), see [docs/local-docker-testing.md](docs/local-docker-testing.md). Typical amd64 build:
+
+```bash
+./scripts/docker-build-platform.sh linux/amd64 videosphere:amd64-test
+```
+
 ## Notes
 
 - This repository uses MongoDB for auth/session-related data and application persistence.

__tests__/api/drafts/drafts-id.test.ts

@@ -35,9 +35,14 @@ vi.mock('@/lib/r2', async (importOriginal) => {
   };
 });
 
+vi.mock('@/lib/repositories/users', () => ({
+  upsertDraftLabelsInLibrary: vi.fn(),
+}));
+
 import { GET, PATCH, DELETE } from '@/app/api/drafts/[id]/route';
 import { getAuthenticatedUserId } from '@/lib/api/auth';
 import { getDraftById, updateDraft, deleteDraft } from '@/lib/repositories/drafts';
+import { upsertDraftLabelsInLibrary } from '@/lib/repositories/users';
 import { deleteObject, buildDraftThumbnailFinalKey } from '@/lib/r2';
 import { DraftDocumentTooLargeError, MAX_DRAFT_TITLE_LENGTH } from '@/lib/draft-upload-metadata';
 
@@ -472,6 +477,23 @@ describe('PATCH /api/drafts/[id]', () => {
       expect(updateDraft).toHaveBeenCalledWith(DRAFT_ID, { tags: ['a', 'b'] });
     });
 
+    it('returns 200 when label library upsert fails after the draft is updated', async () => {
+      const updated = { ...baseDraft, labels: ['Sunday'] };
+      vi.mocked(updateDraft).mockResolvedValueOnce(updated);
+      vi.mocked(upsertDraftLabelsInLibrary).mockRejectedValueOnce(new Error('db down'));
+
+      const res = await PATCH(
+        makeRequest('PATCH', { labels: ['Sunday'] }, { [SESSION_COOKIE]: 'tok' }),
+        makeParams()
+      );
+
+      expect(res.status).toBe(200);
+      const body = await res.json();
+      expect(body.message).toBe('Draft updated');
+      expect(body.data.labels).toEqual(['Sunday']);
+      expect(upsertDraftLabelsInLibrary).toHaveBeenCalledWith('user-123', ['Sunday']);
+    });
+
     it('updates multiple fields at once', async () => {
       const updated = {
         ...baseDraft,

__tests__/api/drafts/drafts.test.ts

@@ -35,10 +35,15 @@ vi.mock('@/lib/repositories/upload-jobs', () => ({
   listUploadJobsByUserForDraftIds: vi.fn(async () => []),
 }));
 
+vi.mock('@/lib/repositories/users', () => ({
+  upsertDraftLabelsInLibrary: vi.fn(),
+}));
+
 import { POST, GET } from '@/app/api/drafts/route';
 import { getAuthenticatedUserId } from '@/lib/api/auth';
 import { createDraft, listDraftsByUser, markDraftUsedInUpload } from '@/lib/repositories/drafts';
 import { listUploadJobsByUserForDraftIds } from '@/lib/repositories/upload-jobs';
+import { upsertDraftLabelsInLibrary } from '@/lib/repositories/users';
 import { DraftDocumentTooLargeError, MAX_DRAFT_TITLE_LENGTH } from '@/lib/draft-upload-metadata';
 
 // ---------------------------------------------------------------------------
@@ -305,6 +310,7 @@ describe('POST /api/drafts', () => {
         title: 'My Video',
         description: 'Great video',
         tags: [],
+        labels: [],
         targets: ['youtube', 'vimeo'],
         platforms: {},
         backupNaming: normalizeBackupFileNameSettings(undefined),
@@ -353,6 +359,24 @@ describe('POST /api/drafts', () => {
 
       expect(createDraft).toHaveBeenCalledWith(expect.objectContaining({ userId: 'user-123' }));
     });
+
+    it('returns 201 when label library upsert fails after the draft is created', async () => {
+      vi.mocked(createDraft).mockResolvedValueOnce({ ...baseDraft, labels: ['Sunday'] });
+      vi.mocked(upsertDraftLabelsInLibrary).mockRejectedValueOnce(new Error('db down'));
+
+      const req = makeRequest(
+        'POST',
+        { title: 'My Video', targets: ['youtube'], labels: ['Sunday'] },
+        { [SESSION_COOKIE]: 'tok' }
+      );
+      const res = await POST(req);
+
+      expect(res.status).toBe(201);
+      const body = await res.json();
+      expect(body.message).toBe('Draft created');
+      expect(body.data.labels).toEqual(['Sunday']);
+      expect(upsertDraftLabelsInLibrary).toHaveBeenCalledWith('user-123', ['Sunday']);
+    });
   });
 
   describe('Repository errors', () => {