Quickstart

// Team creation from convex/teams.ts
const teamId = await ctx.db.insert("teams", {
  name: args.name,
  slug,
  ownerClerkId: user.subject,
  plan: "basic",
  billingStatus: "not_subscribed",
});

// You're automatically added as team owner
await ctx.db.insert("teamMembers", {
  teamId,
  userClerkId: user.subject,
  userEmail: normalizedEmail(identityEmail(user)),
  userName: identityName(user),
  role: "owner",
});

// Video creation from convex/videos.ts
const videoId = await ctx.db.insert("videos", {
  projectId: args.projectId,
  uploadedByClerkId: user.subject,
  uploaderName: identityName(user),
  title: args.title,
  description: args.description,
  fileSize: args.fileSize,
  contentType: args.contentType,
  status: "uploading",
  muxAssetStatus: "preparing",
  workflowStatus: "review", // Default workflow status
  visibility: "public",
  publicId,
});

// Creating a comment from convex/comments.ts
return await ctx.db.insert("comments", {
  videoId: args.videoId,
  userClerkId: user.subject,
  userName: identityName(user),
  userAvatarUrl: identityAvatarUrl(user),
  text: args.text,
  timestampSeconds: args.timestampSeconds, // Auto-captured from player
  parentId: args.parentId, // For threaded replies
  resolved: false,
});

// Share link creation from convex/shareLinks.ts
await ctx.db.insert("shareLinks", {
  videoId: args.videoId,
  token, // Unique 32-character token
  createdByClerkId: user.subject,
  createdByName: identityName(user),
  expiresAt, // Optional expiration timestamp
  allowDownload: args.allowDownload ?? false,
  passwordHash, // Securely hashed password
  viewCount: 0,
});

// Team invitation from convex/teams.ts
const token = generateToken();
const expiresAt = Date.now() + 7 * 24 * 60 * 60 * 1000; // 7 days

await ctx.db.insert("teamInvites", {
  teamId: args.teamId,
  email: inviteEmail,
  role: args.role,
  invitedByClerkId: user.subject,
  invitedByName: identityName(user),
  token,
  expiresAt,
});